Get Customer Volume

This API is used to retrieve customer volume data, aggregated 1-day intervals.

Request

Request-Line

POST /cdn/v1.0/analytics/getVolumeByCustomerId HTTP/1.1

Request Parameters

Body Parameters

Parameter	Type	Required	Description
startTime	String	Mandatory	Start time. Using the time format: yyyy-MM-ddT00:00:00Z.
endTime	String	Mandatory	End time. Using the time format: yyyy-MM-ddT00:00:00Z. Note: The duration between the start time and end time cannot be longer than 90 days.

Response

Response Body

Parameter	Type	Description
	Array	Array of serviceName Volume.

Object: Service Volume

Parameter	Type	Description
timestamp	String	Specify in UTC using the format yyyy-MM-ddTHH:mm:ssZ. Example: 2025-09-09T17:35:00Z.
value	Float	Displays the volume value in bps. Example: 94.33.

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	Request.BadRequest	Bad request.
400	CustomerId.Invalid	Customer id is empty or invalid.
400	Time.Invalid	StartTime or EndTime is required.
400	DayIntervalTimeFormat.Invalid	StartTime or EndTime format in 'yyyy-MM-dd'T'00:00:00'Z''.
400	TimeRange.Exceeded	The difference between EndTime and StartTime cannot exceed 90 days.
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	GetVolume.OperationFailed	Get Volume failed.

Examples

Get Customer Volume

Request

POST /cdn/v1.0/analytics/getVolumeByCustomerId HTTP/1.1

{
    "startTime": "2025-11-06T00:00:00Z",
    "endTime": "2025-11-09T00:00:00Z"
}

Successful Response Body

[
    {
        "timestamp": "2025-11-06T00:00:00Z",
        "value": 8984842662053294
    },
    {
        "timestamp": "2025-11-07T00:00:00Z",
        "value": 9358693958303120
    },
    {
        "timestamp": "2025-11-08T00:00:00Z",
        "value": 10013127294236162
    }
]