Updated on 2024-01-19 GMT+08:00

Querying Details of a Purchased API Group

Function

This API is used to query the details of a purchased API group.

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

GET

/v1.0/apigw/purchases/groups/{purchase_id}

The following table lists the parameter in the URI.

Table 2 Parameter description

Parameter

Mandatory

Type

Description

purchase_id

Yes

String

Subscription ID

Request

N/A

Response

Table 3 Parameter description

Parameter

Type

Description

id

String

Subscription ID

group_id

String

API group ID

group_name

String

API group name

group_remark

String

Description of the API group

order_time

Timestamp

Time when the order is placed

start_time

Timestamp

Time when the order takes effect

expire_time

Timestamp

Time when the order expires

group_domains

[]String

List of API group domain names. A value will be returned when you query the details of a purchased API group.

quota_left

Integer

Remaining API call quota

quota_used

Integer

Used API call quota

app_key

String

Generated AppKey

app_secret

String

Generated AppSecret

Example response:

{
  "id": "3f3****cc587",
  "group_id": "73c58****7f09",
  "group_name": "api_group_001",
  "group_remark": "API group 001",
  "group_domains": [
    "test.market.example.com"
  ],
  "quota_used": 0,
  "quota_left": 2000000000,
  "order_time": "2018-01-02T10: 51: 26Z",
  "start_time": "2018-01-01T00: 00: 00Z",
  "expire_time": "2019-01-01T00: 00: 00Z",
  "app_key": "0e242****4785",
  "app_secret": "******"
}

Status Codes

Table 4 Status codes

Status Code

Description

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found