Overview
GET "/" endpoint is the main one which returns information about the app. You can find response structure here. Response example:
{
"version": "1.0", // string representing the version of your app
"name": "My Super Application", // title of the app
"description": "All your base are belong to us!", // long description
"authentication": [], // list of possible account authentication approaches
"sources": [], // empty error
"responsibleFor": { // app responsibility
"dataSynchronization": true // indicates that app is responsible for data synchronization
}
}
Authentication Information
The authentication
object includes all account schema information. It informs the Fibery front-end
how to build forms for the end-user to provide required account information. This property is required,
even if your application does not require authentication. At least one authentication object must be provided
within array.
{
"authentication": [
{
"id": "basic", // identifier
"name": "Basic Authentication", // user-friendly title
"description": "Just using a username and password", // description
"fields": [ //list of fields to be filled
{
"id": "username", //field identifier
"title": "Username", //friendly name
"description": "Your username, duh!", //description
"type": "text", //field type (text, password, number, etc.)
"optional": true, // is this a optional field?
},
/* ... */
]
}
]
}
In case when application doesn't require authentication, the fields
array must be omitted.
Read more about fields here.
Important note: if your app provides OAuth capabilities for authentication, the authentication
identifiers must be oauth
and oauth2
for OAuth v1 and OAuth v2, respectively.
Only one authentication type per OAuth version is currently supported.