Retrieve Backends
/mobile/tools/1.0/mobilebackends
Request
- application/json
- exclude
-
Type:
array
Collection Format:multi
Expression to exclude from the result the elements that have IDs in the list. Example:exclude=57165555-aa10-4838-938a-354c2b3a287sa&exclude=57165555-aa10-4838-938a-354c2b3a287s
-
Type:
string
-
- filterType
-
Type:
string
Allowed Values: [NOT_PUBLISHED, PUBLISHED, NOT_TRASH, TRASH, ACTIVE, INACTIVE].Filter backends by the following filter types. You can provide multiple values as a comma-separated string. For example,
filterType=NOT_PUBLISHED,NOT_TRASH,ACTIVE
.PUBLISHED
returns all backends that are in the published state.NOT_PUBLISHED
returns all backends that aren't in the published state.TRASH
returns all backends that have theinTrash
attribute set totrue
.NOT_TRASH
returns all backends that have theinTrash
attribute set tofalse
.ACTIVE
returns all backends that have theinactive
attribute set tofalse
.INACTIVE
returns all backends that have theinactive
attribute set totrue
.
- fromTime
-
Type:
string
Include only the assets that have been modified or deleted on or after the specified time. Example:
2016-03-03T15:13:39.419Z
.Filters by
modifiedOn
for assets that haven't been trashed and bydeletedOn
for trashed assests.Supported values:
- Number of milliseconds since January 1, 1970, 00:00:00 GMT
- Date in ISO 8601 format
- Relative value, such as -1s, -1m, and -1h
- id
-
Type:
array
Collection Format:multi
Expression to return only the elements that have IDs in the list. Example:id=93079180-bb00-4838-938a-753c2b3a957a&id=57165555-aa10-4838-938a-354c2b3a287s
-
Type:
string
-
- limit
-
Type:
integer
(int64
)The maximum number of items to return. If the total number of items to return is greater than the limit, then the response returns a link to get the next set of items. - offset
-
Type:
integer
(int64
)The index where you want to start browsing the list of items. If you don't specify an offset, then the offset defaults to 0, which is the first item in the list. The response contains the offset used and a link to get the previous set of items. - orderBy
-
Type:
string
The sort order for the results. The default sort order is ascending by name. When you specify a sort order with pagination, the next and previous links respect the ordering. Multiple values can be provided as a comma-separated string. Format: `orderBy=attr[:("asc"|"desc")] [,attr[:("asc"|"desc")]]`, where the `attr` parameter can be one of [ name | version | modifiedOn | createdOn | deletedOn | deletedBy ]. Example: `orderBy=name:asc,modifiedOn:desc`name:asc
- q
-
Type:
string
Performs a case-insensitive search for backends that have a name, display name, or description that contains the string that's provided in this parameter. For example,q=myBackend
. This parameter doesn't support query languages. - toTime
-
Type:
string
Include only the assets that have been modified or deleted on or before the specified time. Example:
2016-03-03T15:13:39.419Z
.Filters by
modifiedOn
for assets that haven't been trashed and bydeletedOn
for trashed assests.Supported values:
- Number of milliseconds since January 1, 1970, 00:00:00 GMT
- Date in ISO 8601 format
- Relative value, such as -1s, -1m, and -1h
- totalResults
-
Type:
boolean
Reserved for enabling the total number of available elements in the response. This parameter is ignored because the total elements count always is available and is provided in the response.
- Accept-Language
-
Type:
string
Indicates the preferred set of natural languages to use for the response. The results are sorted based on the language. Example:da, en-gb;q=0.8, en;q=0.7
.
Response
- application/json
object
-
Type:
object
pagingAdditional Properties Allowed:The pagination information. -
Type:
object
mobilebackendPaging-allOf[1]Additional Properties Allowed:
object
- count
-
Type:
integer
(int64
)Required:true
The number of elements in this response. - hasMore
-
Type:
boolean
Required:true
Indicates whether the collection has more elements to be retrieved. - limit
-
Type:
integer
(int64
)The maximum number of items returned. If the total number of items to return is greater than the limit, then the response returns a link to get the next set of items. - links
-
Type:
array
paginationLinksArrayAdditional Properties Allowed:Minimum Number of Items:0
An array of links for paginated metadata. - totalResults
-
Type:
integer
(int64
)The total number of elements on the server side that satisfy the request. This attribute is returned only when the request includes the `totalResults` query parameter with a value of `true`.
- items
-
Type:
array
mobilebackendArrayAdditional Properties Allowed:Minimum Number of Items:0
An array of metadata about the mobile backends.
array
0
-
Type:
object
Link to the paginated metadata.Title:Link to the paginated metadata.
Additional Properties Allowed:
object
Link to the paginated metadata.
- href
-
Type:
string
Required:true
Link value. - rel
-
Required:
true
Allowed Values:[ "self", "canonical", "next", "prev", "first", "last" ]
Link type.
array
0
-
Type:
object
mobilebackendListGetAdditional Properties Allowed:The backend representation for GET requests.
object
-
Type:
object
mobilebackendShortGetAdditional Properties Allowed:The backend representation for GET requests. -
Type:
object
mobilebackendListGet-allOf[1]Additional Properties Allowed:
object
-
Type:
object
assetGetAdditional Properties Allowed:The asset representation for GET requests. -
Type:
object
mobilebackendOAuthKeysAdditional Properties Allowed:The client keys (client_id/client_secret) that are required for backend access using OAuth. -
Type:
object
mobilebackendBasicAuthKeysAdditional Properties Allowed:The mobile backend ID that's required for backend access when you use Basic access authorization. -
Type:
object
mobilebackendShortGet-allOf[3]Additional Properties Allowed:
- identityProviders
-
Type:
array
identityProviderArrayAdditional Properties Allowed:Minimum Number of Items:0
An array of the identity providers' metadata.
object
-
Type:
object
assetUpdateAdditional Properties Allowed:The asset representation for PUT requests. -
Type:
object
assetIdEtagAdditional Properties Allowed:The asset ID and entity tag (ETag) values. -
Type:
object
trashAdditional Properties Allowed:Indicator of whether the asset is in the trash. -
Type:
object
assetGet-allOf[3]Additional Properties Allowed:
object
- clientID
-
Type:
string
Required:true
- clientSecret
-
Type:
string
Required:true
- sso
-
Type:
boolean
object
- basicAuthBackendId
-
Type:
string
Required:true
- basic
-
Type:
boolean
- inactive
-
Type:
boolean
- oauth
-
Type:
boolean
- roleAccess
-
Type:
object
mobilebackendRoleAccessAdditional Properties Allowed:The backend's role-access details.
object
- actionComment
-
Type:
string
- desc
-
Type:
string
Maximum Length:100
- max
-
Type:
boolean
Default Value:false
- name
-
Type:
string
Required:true
Maximum Length:100
Pattern:^[a-zA-Z][a-zA-Z0-9_]*$
- namespace
-
Type:
string
Applicable to APIs and implementations only. This value is null for all other asset types. - title
-
Type:
string
Maximum Length:255
- version
-
Type:
string
Maximum Length:100
Pattern:^[a-zA-Z0-9][\w.]*$
Asset version.
object
- etag
-
Type:
string
The asset entity tag (ETag) value, which you can use to detect concurrent modification. - id
-
Type:
string
Required:true
- createdOn
-
Type:
string
- deletedBy
-
Type:
string
- deletedOn
-
Type:
string
- links
-
Type:
array
entityLinksArrayAdditional Properties Allowed:Minimum Number of Items:0
An array of links for an entity's metadata. - modifiedBy
-
Type:
string
- modifiedOn
-
Type:
string
- published
-
Type:
boolean
An asset draft or published status representation.
object
- href
-
Type:
string
Required:true
Link value. - rel
-
Required:
true
Allowed Values:[ "self", "canonical" ]
Link type.
object
- enabled
-
Type:
boolean
- roles
-
Type:
array
stringArrayAdditional Properties Allowed:Minimum Number of Items:0
An array of string values.
array
0
-
Type:
object
identityProviderAdditional Properties Allowed:Identity provider representation.
object
- credential
-
Type:
object
identityProviderCredentialGetAdditional Properties Allowed:Information about a CSF key for an identity provider that is enabled for the backend. - enabled
-
Type:
boolean
Required:true
Indicates if the identity provider is enabled or disabled. - id
-
Type:
string
Required:true
Identity provider identifier. - name
-
Type:
string
Required:true
Identity provider name. This must be a unique value.
object
- appId
-
Type:
string
The application ID that was provided by the platform vendor that you obtained the certificate from. - appSecret
-
Type:
boolean
Indicates whether the password is set. - csfKeyName
-
Type:
string
Required:true
The name of the CSF key. - description
-
Type:
string
The description of the key's purpose.
Examples
The following example shows how to get metadata about the most recently created backend. For more information about cURL, see Use cURL.
curl -i -X GET -H "Authorization: Bearer $TOKEN" "$BASE_URL/mobile/tools/1.0/mobilebackends?limit=1&orderBy=modifiedOn:desc"
Example of Response Header
The following shows an example of the response headers.
Example: 200 OK Content-Length: 3018 Content-Type: application/json Date: Thu, 05 Oct 2017 01:21:58 GMT
Example of Response Body
The following example shows, in JSON format, the contents of the response body.
{ "count": 1, "totalResults": 5, "hasMore": true, "links": [ { "rel": "next", "href": "/mobile/tools/1.0/mobilebackends?offset=1&limit=1&totalResults=true" }, { "rel": "first", "href": "/mobile/tools/1.0/mobilebackends?offset=0&limit=1&totalResults=true" }, { "rel": "last", "href": "/mobile/tools/1.0/mobilebackends?offset=4&limit=1&totalResults=true" }, { "rel": "canonical", "href": "/mobile/tools/1.0/mobilebackends" }, { "rel": "self", "href": "/mobile/tools/1.0/mobilebackends?limit=1&orderBy=modifiedOn%3Adesc" } ], "items": [ { "id": "2ec3d6d7-4cbe-4785-8303-6b4221602c8b", "name": "motd", "version": "1.0", "desc": "Message of the Day", "links": [ { "rel": "canonical", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b" }, { "rel": "purgeDependencies", "href": "/mobile/tools/1.0/assets/purgeDependencies" }, { "rel": "purging", "href": "/mobile/tools/1.0/assets/purging" }, { "rel": "trashDependencies", "href": "/mobile/tools/1.0/assets/trashDependencies" }, { "rel": "trashing", "href": "/mobile/tools/1.0/assets/trashing" }, { "rel": "untrashDependencies", "href": "/mobile/tools/1.0/assets/untrashDependencies" }, { "rel": "untrashing", "href": "/mobile/tools/1.0/assets/untrashing" }, { "rel": "dependencies", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/dependencies" }, { "rel": "history", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/history" }, { "rel": "publication", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/publication" }, { "rel": "reverseDependencies", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/reverseDependencies" }, { "rel": "notifications", "href": "/mobile/tools/1.0/notifications/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/notifications" }, { "rel": "apis", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/apis" }, { "rel": "collections", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/collections" }, { "rel": "basicAuthentication", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/security/basic" }, { "rel": "basicAuthenticationKeys", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/security/basic/keys" }, { "rel": "identityProviders", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/security/identityproviders" }, { "rel": "oauthKeys", "href": "/mobile/tools/1.0/mobilebackends/2ec3d6d7-4cbe-4785-8303-6b4221602c8b/security/oauth/keys" } ], "published": false, "inTrash": false, "actionComment": null, "etag": "1", "createdOn": "2017-10-05T01:21:10.158Z", "modifiedOn": "2017-10-05T01:21:10.158Z", "modifiedBy": "jdoe", "deletedOn": null, "deletedBy": null, "clientId": "2e7325ad6d744e2c9f9f7d8c4d638d2e", "clientSecret": "f2bba628-3a94-44f0-a97a-f2f826e86dcb", "basicAuthBackendId": "4db53cf9-4ac6-444f-890c-ae8e263a866c", "oauth": true, "basicAuth": true, "identityProviders": [ { "id": "bbc6e92b14eb0e6a899b767f1cbbc006", "name": "facebook", "enabled": false, "credential": null } ], "inactive": false, "roleAccess": { "enabled": false, "roles": [] } } ] }