Updated on 2022-09-15 GMT+08:00

Querying API Statistics Details

Function

This API is used to query API statistics details.

URI

GET /v1/{project_id}/service/statistic/apis-detail/{api_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

api_id

Yes

String

API ID

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

instance_id

No

String

Cluster ID

start_time

Yes

Long

Start time, which is a 13-digit timestamp

end_time

Yes

Long

End time, which is a 13-digit timestamp

time_unit

Yes

String

Time unit

Enumeration values:

  • HOUR

  • DAY

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

IAM Token

Workspace

No

String

Workspace ID

Dlm-Type

Yes

String

DLM edition

Enumeration values:

  • SHARED

  • EXCLUSIVE

Response Parameters

Status code: 204

Table 4 Response body parameters

Parameter

Type

Description

id

String

Statistics object ID

name

String

Statistics object name

call_num

Integer

Number of calls

success_num

Integer

Number of successful calls (data obtained)

fail_num

Integer

Number of failed calls (failed to obtain data)

legal_num

Integer

Number of legal calls (verification passed)

illegal_num

Integer

Number of illegal calls (failed to pass verification)

cost_time_avg

Number

Average request duration

success_cost_time_avg

Number

Average duration of successful requests

fail_cost_time_avg

Number

Average duration of failed requests

success_rate

Number

Success rate

fail_rate

Number

Failure rate

legal_rate

Number

Rate of legal calls

illegal_rate

Number

Rate of illegal calls

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error code

error_msg

String

Error message

Example Requests

None

Example Responses

Status code: 204

API statistics details are obtained.

{
  "id" : "3423634676234236674",
  "name" : "Name of the statistics object",
  "call_num" : 0,
  "success_num" : 0,
  "fail_num" : 0,
  "legal_num" : 0,
  "illegal_num" : 0,
  "cost_time_avg" : 0,
  "success_cost_time_avg" : 0,
  "fail_cost_time_avg" : 0,
  "success_rate" : 0,
  "fail_rate" : 0,
  "legal_rate" : 0,
  "illegal_rate" : "0\r"
}

Status Codes

Status Code

Description

204

API statistics details are obtained.

400

BadRequest