Querying OpenAPI Calls
Function
This API is used to query OpenAPI calling records.
URI
GET /v1/{project_id}/openapi/called-records
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
project_id |
Yes |
String |
Project ID |
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
limit |
No |
Integer |
Page size. The default value is 1000, and the maximum value is 2000. |
|
called_url |
No |
String |
URL of the calling records. Example: /v1/{project_id}/sdg/database/watermark/embed |
|
start_time |
No |
Long |
Start time of the calling records (Unix timestamp in milliseconds). Example: 0 |
|
end_time |
No |
Long |
End time of the calling records (Unix timestamp in milliseconds). Example: 1638515803572 |
|
marker |
No |
String |
Marker of the next page. This parameter is not required for the first page. You need to set this parameter to a return value in the first page of the query results for the next page. |
Request Parameters
None
Response Parameters
Status code: 200
|
Parameter |
Type |
Description |
|---|---|---|
|
total |
Integer |
Total number of API calls |
|
succeed |
Integer |
Number of successful calls |
|
failed |
Integer |
Number of failed calls |
|
openapi_called_records |
Array of OpenApiCalledRecord objects |
List of OpenAPI calls |
|
next_marker |
String |
Marker of the next page |
|
Parameter |
Type |
Description |
|---|---|---|
|
user_name |
String |
Name of the user that called the APIs |
|
user_id |
String |
ID of the user that called the APIs |
|
domain_name |
String |
Domain name of the API calls |
|
domain_id |
String |
Domain IDs of the API calls |
|
request_url |
String |
URL of the API calls |
|
request_method |
String |
HTTP request method |
|
response_code |
String |
HTTP request code |
|
fail_reason |
String |
Failure cause |
|
timestamp |
Long |
Time of the calls (Unix timestamp, in milliseconds) |
Status code: 400
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error Code |
|
error_msg |
String |
Error Message |
Example Requests
Querying OpenAPI Calls
GET /v1/{project_id}/openapi/called-records
Example Responses
Status code: 200
OK
{
"total" : 11,
"succeed" : 11,
"failed" : 0,
"openapi_called_records" : [ {
"user_name" : "xxxxxxxxxxxxx",
"user_id" : "xxxxxxxxxxxxxxxxx",
"domain_name" : "xxxxxxxxxxxxxxxxx",
"domain_id" : "xxxxxxxxxxxxxxxxxxx",
"request_url" : "/v1/xxxxxxxxxxxxxxxxxxxxxxxxxxx/sdg/doc/watermark/embed",
"request_method" : "POST",
"response_code" : "200",
"fail_reason" : "",
"timestamp" : 1638427576524
} ],
"next_marker" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
Status code: 400
Invalid request
{
"error_code" : "dsc.40000011",
"error_msg" : "Invalid parameter"
}
Status Codes
|
Status Code |
Description |
|---|---|
|
200 |
OK |
|
400 |
Invalid request |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.