Updated on 2025-02-08 GMT+08:00

Querying Details

Function

This interface is used to query call exception details of a specified app.

You can query data of the last five days.

URI

GET /v1/{project_id}/rtc/client/event

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

app_id

Yes

String

Application ID.

room_id

No

String

Room ID.

start_time

Yes

String

Indicates the start time, which is a UTC time in yyyy-mm-ddThh:mm:ssZ format, for example, 2020-04-23T06:00:00Z. The query start time and end time do not exceed one hour. When a single subscriber is queried, the query can be performed across days. The maximum query time is one day.

end_time

Yes

String

End time, which is a UTC time in yyyy-mm-ddThh:mm:ssZ format, for example, 2020-04-23T06:00:00Z.

The query start time and end time do not exceed one hour. When a single subscriber is queried, the query can be performed across days. The maximum query time is one day.

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response header parameters

Parameter

Type

Description

X-request-id

String

Unique ID of the request.

Table 4 Response body parameters

Parameter

Type

Description

ctime

String

Time

event_id

String

Abnormal event ID.

event_info

String

Abnormal event information.

Status code: 400

Table 5 Response header parameters

Parameter

Type

Description

X-request-id

String

Unique ID of the request.

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

None

Example Responses

Status code: 200

The processing is successful.

{
  "ctime" : "2021-04-23T09:55:32Z",
  "event_id" : 1001,
  "event_info" : "xxx"
}

Status code: 400

Request error.

{
  "error_code" : "400",
  "error_msg" : "need app_id room_id args"
}

Status Codes

Status Code

Description

200

The processing is successful.

400

Request error.

Error Codes

See Error Codes.