Get an application

get

/rest/ofscMetadata/v1/applications/{label}

This operation retrieves API configuration about a single application.

Request

Path Parameters
  • Minimum Length: 1
    Maximum Length: 255
    The unique identifier of the application.
Back to Top

Response

Supported Media Types

200 Response

This section describes the 200 status response for this operation.
Body ()
Root Schema : Application
Type: object
Title: Application
Show Source
  • Allowed CORS Domains List
    Title: Allowed CORS Domains List
    Maximum Number of Items: 100
    The list of origin domains which are allowed to send requests to OFSC REST API. The max size of a value is 1020 symbols or 100 domain entries.
  • IP Addresses To Allow
    Title: IP Addresses To Allow
    The specified IP addresses accessible to the application. If no IP address is specified, then all IP addresses are accessible.
  • Title: Label
    Minimum Length: 1
    Maximum Length: 255
    The label of the application.
  • Title: Name
    Minimum Length: 1
    Maximum Length: 255
    The name of the application.
  • Resources To Allow
    Title: Resources To Allow
    The specified resourceInternalIds and resourceIds (external IDs) of resources accessible to the application. The parameter includes all the children of the specified resource. If the resourceInternalIds and resourceIds (external IDs) of resources are not specified, then the application accesses the root resource. If resourceId and resourceInternalId are used in the request parameter, then the application considers the resourceID (unless it is empty).
  • Title: Status
    Allowed Values: [ "active", "inactive" ]
    The status of the application.
  • Title: Token Service
    Allowed Values: [ "ofsc", "external", "idcs" ]
    The token service used by the application.
Nested Schema : Allowed CORS Domains List
Type: array
Title: Allowed CORS Domains List
Maximum Number of Items: 100
The list of origin domains which are allowed to send requests to OFSC REST API. The max size of a value is 1020 symbols or 100 domain entries.
Show Source
Nested Schema : IP Addresses To Allow
Type: array
Title: IP Addresses To Allow
The specified IP addresses accessible to the application. If no IP address is specified, then all IP addresses are accessible.
Show Source
Nested Schema : Resources To Allow
Type: array
Title: Resources To Allow
The specified resourceInternalIds and resourceIds (external IDs) of resources accessible to the application. The parameter includes all the children of the specified resource. If the resourceInternalIds and resourceIds (external IDs) of resources are not specified, then the application accesses the root resource. If resourceId and resourceInternalId are used in the request parameter, then the application considers the resourceID (unless it is empty).
Show Source
Nested Schema : Resources To Allow
Type: object
Title: Resources To Allow
Show Source

Default Response

This section describes the default error response for this operation.
Body ()
Root Schema : Error
Type: object
Error response
Show Source
Back to Top

Examples

The following example shows how to retrieve an application item by submitting a GET request on the REST resource using cURL:

cURL Command Example

curl -u 'clientId@instance:clientSecret' \
 -X GET \
 --url 'https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/fc64d555ab61b69f7df8ad168d2a6672f8755ac2'

Response Header Example

The following shows an example of the response header.

HTTP/1.1 200 OK
Server: nginx
Date: Thu, 03 Mar 2016 16:28:18 GMT
Content-Type: application/json; charset=utf-8
Connection: close

Response Body Example

The following shows an example of the response body in JSON format.

{
    "label": "fc64d555ab61b69f7df8ad168d2a6672f8755ac2",
    "name": "App Soap_metadata",
    "status": "active",
    "tokenService": "ofsc",
    "resourcesToAllow": [
        {
            "resourceId": "GAS",
            "resourceInternalId": 383
        },
        {
            "resourceId": "EL_ELECTRICO",
            "resourceInternalId": 384
        }
    ],
    "IPAddressesToAllow": [
        "0.0.0.0",
        "1.1.1.1"
    ],
    "allowedCorsDomains": ["https://best.customer.01.dot.com", "https://example.com"],
    "links": [
        {
            "rel": "canonical",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/fc64d555ab61b69f7df8ad168d2a6672f8755ac2"
        },
        {
            "rel": "apiAccess",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/fc64d555ab61b69f7df8ad168d2a6672f8755ac2/apiAccess"
        },
        {
            "rel": "describedby",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/applications"
        }
    ]
}
Back to Top