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. Use the format yyyy-MM-ddT00:00:00Z (e.g., 2024-01-15T00:00:00Z).
endTime	String	Mandatory	End time. Use the format yyyy-MM-ddT00:00:00Z (e.g., 2024-01-16T00:00:00Z).

Response

Response Body

Parameter	Type	Description
	Array	Array of Service Volume object.

Object: Service Volume

Parameter	Type	Description
timestamp	String	Timestamp in UTC, Use the format yyyy-MM-ddT00:00:00Z.
value	Long	Volume value in bytes (e.g., 1024).

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	CustomerId.Invalid	Customer ID is empty or invalid.
400	Time.Invalid	StartTime or EndTime is required.
400	DayIntervalTimeFormat.Invalid	StartTime or EndTime must use the format yyyy-MM-ddT00:00:00Z.
400	TimeRange.Exceeded	The time range between StartTime and EndTime cannot exceed 90 days.
400	TimeRange.EndBeforeStart	EndTime must be later than StartTime.
400	Interval.Invalid	Interval is invalid.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.

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
    }
]