Retrieve API
get
/mobile/tools/1.0/apis/{id}
Returns the API metadata.
Request
Supported Media Types
- application/json
Path Parameters
-
id: string
The identifier of the API.
Response
Supported Media Types
- application/json
200 Response
API metadata.
Headers
-
ETag: string
The ETag corresponds to the state of the API (that is, the value increments by one on each change operation). You can use this ETag with the `If-Match` HTTP header on a request.
The API representation for GET requests.
Root Schema : apiGet
Type:
object
The API representation for GET requests.
Match All
Show Source
-
object apiShort
The short API definition representation.
-
object apiGet-allOf[1]
Nested Schema : apiShort
Type:
object
The short API definition representation.
Match All
Show Source
-
object assetGet
The asset representation for GET requests.
-
object apiShort-allOf[1]
Nested Schema : apiGet-allOf[1]
Type:
Show Source
object
-
apiDefn:
array stringArray
Minimum Number of Items:
0
An array of string values. -
businessObjectsDefn:
string
-
category:
Allowed Values:
[ "CUSTOM", "PLATFORM", "SYSTEM", "CONNECTOR" ]
-
security:
object apiSecurity
The API security for POST and PUT requests.
Nested Schema : assetGet
Type:
object
The asset representation for GET requests.
Match All
Show Source
-
object assetUpdate
The asset representation for PUT requests.
-
object assetIdEtag
The asset ID and entity tag (ETag) values.
-
object trash
Indicator of whether the asset is in the trash.
-
object assetGet-allOf[3]
Nested Schema : apiShort-allOf[1]
Type:
Show Source
object
-
basePath:
string
The API base path in the format `/mobile/custom/{apiName}`.
-
hasBusinessObjects:
boolean
Default Value:
false
Indicates whether the API is associated with API Express resources (business objects). -
icon:
object icon
Information about the icon that's associated with the API or connector.
Nested Schema : assetUpdate
Type:
object
The asset representation for PUT requests.
Show Source
-
actionComment:
string
-
desc:
string
Maximum Length:
100
-
max:
boolean
Default Value:
false
-
name:
string
Maximum Length:
100
Pattern:^[a-zA-Z][a-zA-Z0-9_]*$
-
namespace:
string
Applicable to APIs and implementations only. This value is null for all other asset types.
-
title:
string
Maximum Length:
255
-
version:
string
Maximum Length:
100
Pattern:^[a-zA-Z0-9][\w.]*$
Asset version.
Nested Schema : assetIdEtag
Type:
object
The asset ID and entity tag (ETag) values.
Show Source
-
etag:
string
The asset entity tag (ETag) value, which you can use to detect concurrent modification.
-
id:
string
Nested Schema : assetGet-allOf[3]
Type:
Show Source
object
-
createdOn:
string
-
deletedBy:
string
-
deletedOn:
string
-
links:
array entityLinksArray
Minimum Number of Items:
0
An array of links for an entity's metadata. -
modifiedBy:
string
-
modifiedOn:
string
-
published:
boolean
An asset draft or published status representation.
Nested Schema : entityLinksArray
Type:
array
Minimum Number of Items:
0
An array of links for an entity's metadata.
Show Source
-
[0]:
object items
Link to the entity's metadata.
Nested Schema : items
Type:
object
Link to the entity's metadata.
Show Source
-
href:
string
Link value.
-
rel:
Allowed Values:
[ "self", "canonical" ]
Link type.
Nested Schema : icon
Type:
object
Information about the icon that's associated with the API or connector.
Show Source
Nested Schema : stringArray
Type:
array
Minimum Number of Items:
0
An array of string values.
Show Source
Nested Schema : apiSecurity
Type:
object
The API security for POST and PUT requests.
Show Source
-
access:
object securityAccess
Access details.
-
endpoints:
array endpointSecurityArray
Minimum Number of Items:
0
An array of endpoint security elements. -
loginType:
Allowed Values:
[ "ENTERPRISE", "IDENTITYPROVIDER" ]
If the `required` attribute has a value of `true`, then the default is `ENTERPRISE`. -
required:
boolean
When `true`, either security access or a social identity provider configuration is required.
Nested Schema : securityAccess
Type:
object
Access details.
Show Source
-
all:
boolean
-
roles:
array stringArray
Minimum Number of Items:
0
An array of string values.
Nested Schema : endpointSecurityArray
Type:
array
Minimum Number of Items:
0
An array of endpoint security elements.
Show Source
-
[0]:
object endpointSecurity
The API security for POST and PUT requests.
Nested Schema : endpointSecurity
Type:
object
The API security for POST and PUT requests.
Show Source
-
access:
object securityAccess
Access details.
-
method:
string
-
resource:
string
404 Response
An API with specified ID doesn't exist.
Root Schema : error
Type:
Show Source
object
-
detail:
string
Message that provides the error details.
-
o:ecid:
string
Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
-
o:errorCode:
string
The service's error code.
-
o:errorDetails:
object errorDetails
-
o:errorPath:
string
The relative point in the API path where the error occurred.
-
status:
integer(int64)
HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
Nested Schema : errorDetails
Type:
Show Source
object
-
detail:
string
-
o:errorDetails:
object errorDetails
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.