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.