Get Request Number

Retrieve the data sample of the number of request number, aggregated in 5-minute intervals.

Request

Request-Line

POST /waap/v1.0/analytics/requestNumber HTTP/1.1

Request Parameters

Body Parameters

Parameter	Type	Required	Description
domains	String[]	Mandatory	Array of domain names, the max array size is 50.
startTime	String	Mandatory	Start time. Specify in UTC using the format yyyy-MM-ddTHH:mm:ssZ.
endTime	String	Mandatory	End time. Specify in UTC using the format yyyy-MM-ddTHH:mm:ssZ. Interval between start time and end time cannot be longer than 24 hours.

Response

Response Body

Parameter	Type	Description
	Array	Array of Domain Request Number.

Object: Domain Request Number

Parameter	Type	Description
domain	String	Name of domain.
reqNumbers	Object	Bandwidth values recorded at 5-minute intervals. Array of Request Number.

Object: Request Number

Parameter	Type	Description
timestamp	String	Specify in UTC using the format yyyy-MM-ddTHH:mm:ssZ. E.g., 2025-09-09T17:35:00Z will return data from 2025-09-09T17:35:00Z to 2025-09-09T17:39:59Z.
value	Long	Number of requests within a 5-minute interval, expressed as an integer (e.g., 1342323).

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	Request.BadRequest	Bad request.
400	Domains.Invalid	Domains is empty or invalid.
400	StartTime.Invalid	StartTime is empty or invalid.
400	EndTime.Invalid	EndTime is empty or invalid.
400	TimeRange.Exceeded	The difference between EndTime and StartTime cannot exceed 24 hours.
400	TimeRange.EndBeforeStart	End time must be later than start time.
400	GetRequestNumber.OperationFailed	Get Request Number failed.
404	Domain.NotFound	Domain is not found.

Examples

Get Request Number

Request

POST /waap/v1.0/analytics/requestNumber HTTP/1.1

{
    "domains": [
        "www.example1.com",
        "www.example2.com"
    ],
    "startTime": "2025-09-09T17:35:00Z",
    "endTime": "2025-09-09T17:45:00Z"
}

Successful Response Body

[
    {
        "domain": "www.example1.com",
        "reqNumbers": [
            {
                "timestamp": "2025-09-09T17:35:00Z",
                "value": 102313
            }
        ]
    },
    {
        "domain": "www.example2.com",
        "reqNumbers": [
            {
                "timestamp": "2025-09-09T17:35:00Z",
                "value": 132313
            }
        ]
    }
]