Get applications a user can reference
/apiplatform/management/v1/apis/{apiId}/references/applications
Returns all applications that can be referenced in policies applied to the {apiId}
API.
Users requesting this resource must be assigned the API Manager role and must be issued the Manage API grant for the specified API.
Request
- application/json
-
apiId: string
A unique ID referencing a specific API.
-
fields(optional): array
Collection Format:
csv
Pass optional fields, separated by commas, in this parameter to return them in the response. See the operation's description for a list of field values. -
limit(optional): integer(int32)
Number of items to retrieve.
1
is the minumum;128
is the maximum.Default Value:128
-
offset(optional): integer(int32)
Offset the list returned results by this amount. Default is zero.Default Value:
0
- orderBy(optional): array
-
q(optional): string
Pass filtering criteria, using the SCIM filter expression syntax
-
totalResults(optional): boolean
Include the total result count in the response.Default Value:
false
Response
- application/json
200 Response
object
-
count(optional):
integer(int32)
The number of items in this collection.
object
-
totalResults(optional):
integer(int32)
The total number of results available. Only provided if the showTotalResults query parameter is set to true
object
403 Response
object
-
detail(optional):
string
Detailed error message
-
errorCode(optional):
string
Application specific error code
-
errorDetails(optional):
array errorDetails
additional errors
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error
-
status(optional):
string
HTTP status code
-
title:
string
Summary error message
-
type:
string
Error type
500 Response
object
-
detail(optional):
string
Detailed error message
-
errorCode(optional):
string
Application specific error code
-
errorDetails(optional):
array errorDetails
additional errors
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error
-
status(optional):
string
HTTP status code
-
title:
string
Summary error message
-
type:
string
Error type
Examples
The following example shows how to retrieve all applications can be referenced in policies applied to the API by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL
curl -i -X GET -u apicsadmin:password https://example.com/apiplatform/management/v1/apis/{apiId}/references/applications
{apiId}
is the unique Id for an API. To retrieve available API Ids, see Get APIs.
Example of Response Headers
The following shows an example of the response headers.
HTTP/1.1 200 OK Server: Oracle-Traffic-Director/12.2.1.0.0 Date: Mon, 13 Mar 2017 07:24:25 GMT Content-Length: 375 Content-Type: application/json X-oracle-dms-ecid: f102c33f-1c5b-4409-806d-03bf5706c492-00018fc1 X-oracle-dms-rid: 0 Via: 1.1 otd_opc Proxy-agent: Oracle-Traffic-Director/12.2.1.0.0
Example of Response Body
The following example shows the contents of the response body in JSON format.
{ "offset": 0, "count": 5, "limit": 128, "hasMore": false, "links": [ { "templated": "true", "method": "GET", "rel": "self", "href": "http://example.com:443/apiplatform/management/v1/apis/100/references/applications?offset=0=128" } ], "items": [ { "createdAt": "2018-02-06T22:19:15-0800", "updatedBy": "apcsadmin", "createdBy": "apcsadmin", "name": "Temperature", "id": "103", "updatedAt": "2018-02-09T01:36:45-0800" }, { "createdAt": "2018-02-08T00:39:42-0800", "updatedBy": "apcsadmin", "createdBy": "apcsadmin", "name": "Allied Mortgage Calculator", "description": "Fast and easy real estate mortgage payment calculator", "id": "104", "updatedAt": "2018-02-08T00:39:42-0800" }, { "createdAt": "2018-02-09T02:57:15-0800", "updatedBy": "apcsadmin", "createdBy": "apcsadmin", "name": "Postman FAON", "description": "Postman FAON", "id": "106", "updatedAt": "2018-02-09T02:57:15-0800" }, { "createdAt": "2018-02-13T02:03:16-0800", "updatedBy": "apcsadmin", "createdBy": "apcsadmin", "name": "Subscribeplan", "id": "108", "updatedAt": "2018-02-13T02:03:16-0800" }, { "createdAt": "2018-02-13T22:58:41-0800", "updatedBy": "apcsadmin", "createdBy": "apcsadmin", "name": "New", "id": "110", "updatedAt": "2018-02-13T22:58:41-0800" } ] }