Get applications

get

/rest/ofscMetadata/v1/applications

This operation retrieves the list of applications.

Request

Query Parameters
  • The number of applications to be returned in the response. The minimum value that can be specified is 1 and the maximum value that can be specified is 100. If the specified value is greater than 100, zero, or if no value is specified, then it defaults to 100.
  • The record number from which the retrieval starts. The default value is zero. If no value is specified, then it defaults to zero. The value zero indicates that the retrieval will start from the beginning of the collection.
Back to Top

Response

Supported Media Types

200 Response

This section describes the 200 status response for this operation.
Body ()
Root Schema : Applications
Type: object
The schema of the applications.
Show Source
Nested Schema : items
Type: array
Show Source
Nested 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 the collection of configured applications from OFSC 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'

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.

{
    "hasMore": false,
    "totalResults": 9,
    "limit": 100,
    "offset": 0,
    "items": [
        {
            "label": "34115924505effa92e8c9763b38be7646719a385",
            "name": "App soap",
            "status": "active",
            "tokenService": "ofsc",
            "resourcesToAllow": [],
            "IPAddressesToAllow": [],
            "allowedCorsDomains": ["https://best.customer.01.dot.com", "https://example.com"],
            "links": [
                {
                    "rel": "canonical",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/34115924505effa92e8c9763b38be7646719a385"
                },
                {
                    "rel": "apiAccess",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/34115924505effa92e8c9763b38be7646719a385/apiAccess"
                },
                {
                    "rel": "describedby",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/applications"
                }
            ]
        },
        {
            "label": "a6b0b3b93caec0b228bf6c4e52b2828cd0837d1e",
            "name": "App ODI_Soap",
            "status": "active",
            "tokenService": "ofsc",
            "resourcesToAllow": [],
            "IPAddressesToAllow": [],
            "allowedCorsDomains": ["https://best.customer.01.dot.com", "https://example.com"],
            "links": [
                {
                    "rel": "canonical",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/a6b0b3b93caec0b228bf6c4e52b2828cd0837d1e"
                },
                {
                    "rel": "apiAccess",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/a6b0b3b93caec0b228bf6c4e52b2828cd0837d1e/apiAccess"
                },
                {
                    "rel": "describedby",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/applications"
                }
            ]
        },
        {
            "label": "73e3a9b4a830f4a478d135976570d1545a9d77ef",
            "name": "App Administrador OOEE-GAS",
            "status": "active",
            "tokenService": "ofsc",
            "resourcesToAllow": [],
            "IPAddressesToAllow": [],
            "allowedCorsDomains": ["https://best.customer.01.dot.com", "https://example.com"],
            "links": [
                {
                    "rel": "canonical",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/73e3a9b4a830f4a478d135976570d1545a9d77ef"
                },
                {
                    "rel": "apiAccess",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/73e3a9b4a830f4a478d135976570d1545a9d77ef/apiAccess"
                },
                {
                    "rel": "describedby",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/applications"
                }
            ]
        },
        {
            "label": "5afbd589dd6042de63507621940f2f3a4a477fb6",
            "name": "App UT24_DISPLAY_PROFILE",
            "status": "active",
            "tokenService": "ofsc",
            "resourcesToAllow": [],
            "IPAddressesToAllow": [],
            "allowedCorsDomains": ["https://best.customer.01.dot.com", "https://example.com"],
            "links": [
                {
                    "rel": "canonical",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/5afbd589dd6042de63507621940f2f3a4a477fb6"
                },
                {
                    "rel": "apiAccess",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/applications/5afbd589dd6042de63507621940f2f3a4a477fb6/apiAccess"
                },
                {
                    "rel": "describedby",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/applications"
                }
            ]
        }
    ]
}
Back to Top