Authorizing Apps

Function

An app cannot access any APIs immediately after it is created. To access an API in an environment, first authorize the app to call the API.

URI

The following table lists the HTTP/HTTPS request method and URI of the API.

**Table 1** HTTP/HTTPS request method and URI
Request Method	URI
POST	/v1.0/apigw/app-auths

Request

**Table 2** Parameter description
Parameter	Mandatory	Type	Description
api_ids	Yes	Array of strings	List of API IDs
app_ids	Yes	Array of strings	List of app IDs
env_id	Yes	String	ID of the environment in which the apps will be authorized

Example request:

{
	"api_ids": ["5bbc47e2-95b0-4a56-904e-a3cdc422f8e9",
	"6632a062-9dcf-4f18-9646-3cabb925a290"],
	"app_ids": ["14b399ac-967f-4115-bb62-c0346b4537e9"],
	"env_id": "DEFAULT_ENVIRONMENT_RELEASE_ID"
}

Response

**Table 3** Parameter description
Parameter	Type	Description
--	Dictionary	Authorization list

**Table 4** Parameter description of the authorization list
Parameter	Type	Description
id	String	Authorization ID
api_id	String	API ID
app_id	String	App ID
auth_time	Timestamp	Authorization time
auth_role	String	Authorizer, which can be: PROVIDER CONSUMER
auth_result	String	Authorization result, which can be: SUCCESS SKIPPED

Example response:

[{
	"id": "dffcaff92d144135a9f420fcd485bbf3",
	"api_id": "8aa097b00e9843efabc9c593d11b769d",
	"app_id": "f8c6ea15-0d1b-4c5b-bd4b-911610bd3b3e",
	"auth_time": "2018-03-30T09:37:43.490197204Z",
	"auth_role": "PROVIDER",
	"auth_result": "SUCCESS"
}]