Docs
api
Cloud Delivery(UCDN)
GetNewUcdnLogRefererStatistics

Get hotspot referer statistics - GetNewUcdnLogRefererStatistics

Overview

Get hotspot referer statistics

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is GetNewUcdnLogRefererStatistics.Yes
PublicKeystringThe user’s public key can be obtained from ConsoleYes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
DomainIdstringDomain ID, the ID generated when creating a domainNo
AreacodestringQuery bandwidth area ‘cn’ represents domestic, ‘abroad’ represents overseas; currently only supports domestic.No
BeginTimeintStart time for bandwidth query, format: timestampNo
EndTimeintEnd time for querying statistical logs, format: timestamp. The maximum time interval is 30 days.No
OrderByint0 indicates sorting in descending order by traffic, 1 indicates sorting in descending order by download times, the default is 0.No
LimitintLimit on the number of results returned, default is 1000No

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
RefererStatisticsarray[RefererStatistics]Daily Instance StatisticsNo

Data Model

RefererStatistics

Field NameTypeDescription InformationRequired
DatestringDateNo
RefererListarray[RefererList]Referer Instance TableNo

RefererList

Field NameTypeDescription InformationRequired
RefererstringClient request’s refererNo
RequestTimesintTimesNo
PercentfloatProportion of times, unit %No

Example

Request Example

https://api.dezai.com/?Action=GetNewUcdnLogRefererStatistics
&DomainId=test.com
&Areacode=cn
&BeginTime=1620057600
&EndTime=1620069600
&OrderBy=1
&Limit=100

Response Example

{
  "Action": "GetNewUcdnLogRefererStatisticsResponse",
  "RefererStatistics": [
    {
      "Date": "gBcvvycW",
      "RefererList": [
        {
          "Percent": 1.77674,
          "Referer": "VSfcMdFp",
          "RequestTimes": 5
        }
      ]
    }
  ],
  "RetCode": 0
}