Get application grants
get
/developers/services/v1/applications/grants/types
Returns the grants that can be issued for applications. The name, description, and ID of each grant is returned in the response.
Users requesting this resource must be assigned the API Manager role.
Request
There are no request parameters for this operation.
Back to TopResponse
200 Response
The collection of grant types
Nested Schema : CollectionResponseFeature
Type:
Show Source
object
-
count(optional):
integer(int32)
The number of items in this collection.
Nested Schema : Type
Type:
Show Source
object
-
id:
string
The application type's ID.
-
name(optional):
string
The application type's display name.
403 Response
Forbidden.
Root Schema : Error
Type:
Show Source
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
Unexpected error.
Root Schema : Error
Type:
Show Source
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 grants that can be issued for applications 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:443/developers/services/v1/applications/grants/types
Example of Response Headers
The following shows an example of the response headers.
HTTP/1.1 200 OK Server: Oracle Traffic Director Date: Wed, 20 Dec 2017 05:19:46 GMT Content-type: application/json X-oracle-dms-ecid: 6^3rv0_eR00000000 X-oracle-dms-rid: 0:1
Example of Response Body
The following example shows the contents of the response body in JSON format, including the name, description, and ID of each grant.
{ "count": 2, "links": [ { "method": "GET", "rel": "self", "href": "http://example.com:443/developers/services/v1/applications/grants/types" } ], "items": [ { "name": "Manage Application", "description": "Users issued this grant are allowed to modify and delete this application.", "id": "ManageApplicationGrant" }, { "name": "View all details", "description": "Users issued this grant are allowed to see all details about this application in the Developer Portal.", "id": "ViewAllDetailsApplicationGrant" } ] }