Would you like to contribute to the Titanium docs? To get started, sign up for an account on the Appcelerator Wiki and sign our CLA.

Skip to end of metadata
Go to start of metadata

APIs are defined as Swagger 2.0 documents which can contain one or more Endpoint definitions. The API swagger document must be formatted as JSON and contained within the /endpoints directory of your app. 

When API Builder reads these API swagger definitions, it will create the specified routes for each Endpoint. The implementation of the business logic for each Endpoint is handled by the Flow associated with that Endpoint. This is delegated to Flows which are specified on a per-Endpoint level.

APIs have the following extensions to the swagger specification:

 

Property

Description

Required

Type

Default

Example

x-enabled

If the API should be bound to the app on load.

No

object

{ "enabled": true }

{ "enabled": false }

x-flow

The name of the Flow to be executed when the endpoint is hit.

Yes

string

 

"greetflow"


Example

This example API below is similar to the one that comes with every API Builder Project. It contains an Endpoint which takes a username, invokes the flow called “greetflow”, and returns a greeting. However, since it has an x-enabled flag set, the Endpoint will be disabled, and no requests will be able to be made to it.

 Expand source