Exporting APIs Asynchronously¶
Function¶
This API is used to export APIs in a specified API group. The content of the exported file complies with the Swagger standard. For details about the custom extended fields of APIG, see section "Extended Definition" in the User Guide.
Calling Method¶
For details, see Calling APIs.
URI¶
POST /v2/{project_id}/apigw/instances/{instance_id}/openapi/async-export
Parameter | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Project ID. For details about how to obtain it, see Obtaining a Project ID. |
instance_id | Yes | String | Gateway ID, which can be obtained from the gateway information on the APIG console. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
oas_version | No | String | OpenAPI version. Default: 2.0 Enumeration values:
|
Request Parameters¶
Parameter | Mandatory | Type | Description |
---|---|---|---|
X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
env_id | Yes | String | ID of the environment in which APIs of a group have been published. |
group_id | Yes | String | API group ID. |
define | No | String | Definition scope of the APIs to be exported:
Default: spec Enumeration values:
|
type | No | String | Format for exporting API definitions. Default: json Enumeration values:
|
version | No | String | Version number of the APIs after exporting. The default value is the current date and time. |
apis | No | Array of strings | IDs of the APIs to be exported. |
Response Parameters¶
Status code: 202
Parameter | Type | Description |
---|---|---|
task_id | String | Task ID. |
Status code: 400
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Status code: 401
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Status code: 403
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Status code: 500
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Example Requests¶
Exporting APIs in batches
{
"env_id" : "DEFAULT_ENVIRONMENT_RELEASE_ID",
"group_id" : "c77f5e81d9cb4424bf704ef2b0ac7600",
"define" : "all"
}
Example Responses¶
Status code: 202
Accepted
{
"task_id" : "d9ce8c9eede54b3f841ec324fe0bfdc2"
}
Status code: 400
Bad Request
{
"error_code" : "APIG.2001",
"error_msg" : "The request parameters must be specified,parameterName:env_id. Please refer to the support documentation"
}
Status code: 401
Unauthorized
{
"error_code" : "APIG.1002",
"error_msg" : "Incorrect token or token resolution failed"
}
Status code: 403
Forbidden
{
"error_code" : "APIG.1005",
"error_msg" : "No permissions to request this method"
}
Status code: 500
Internal Server Error
{
"error_code" : "APIG.9999",
"error_msg" : "System error"
}
Status Codes¶
Status Code | Description |
---|---|
202 | Accepted |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
500 | Internal Server Error |
Error Codes¶
See Error Codes.