Customer SupportGet Expert Help
Skip to main content

List Log Files

This API is used to list logs and download URLs with 5 minutes data sample. It will set values array is empty if no logs in the 5 minutes slot.

request​

Request-Line​

POST /cdn/v1.0/log/list HTTP/1.1

Request Parameters​

Query String​

ParameterTypeRequiredDescription
serviceNamesString[]MandatoryArray of ervicei names. The services length should not be greater than 10.
startTimeStringMandatoryStart time. Format yyyy-MM-ddTHH:mm:ssZ UTC time.
endTimeStringMandatoryEnd time. Format yyyy-MM-ddTHH:mm:ssZ UTC time. Interval between start time and end time cannot be longer than 24 hours.

Response​

Response Body​

ParameterTypeDescription
serviceNameStringName of service.
logsLog[]List of log file URLs. see Logs

Object:Logs​

ParameterTypeDescription
timestampStringFormat yyyy-MM-ddTHH:mm:ssZ UTC time. E.g. 2018-03-29T17:35:00Z will return data from 2018-03-29T17:35:00Z to 2018-03-29T17:39:59Z.
valuesLogFile[]Array of log download URL. see values

Object:Values​

ParameterTypeDescription
fileNameStringLog file name.
fileUrlStringLog file download url. with query string "expire" and "sign" for download authentication. the expire time for url is 7 days.
fileSizeStringArray of log download URL.

Status Codes, Error Codes and Error Messages​

Status CodeError CodeError Message
400Request.BadRequestBad request.
400Invalid.ServiceNamesService names is required.
400Invalid.ServiceExceedLimitServiceName limit exceeded.
400StartTime.InvalidEndTime is empty or is invalid.
400EndTime.InvalidThe origin must be in 'scheme://fqdn' format.
400EndTime.MismatchEnd time must be later than start time.
400TimeFormat.InvalidStartTime or EndTime format in 'yyyy-MM-dd'T'HH:mm:ss'Z'.

Examples​

List Log Files​

Request​

POST /cdn/v1.0/log/list HTTP/1.1

{
    "serviceNames": [
        "v53-gl.tiktokrow-cdn.com"
    ],
    "startTime": "2025-10-22T04:00:00Z",
    "endTime": "2025-10-22T10:00:00Z"
}

Successful Response Body​

[
    {
        "serviceName": "v53-gl.tiktokrow-cdn.com",
        "logs": [
            {
                "timestamp": "2025-10-22T04:00:00Z",
                "values": [
                    {
                        "fileName": "20251022040000_202510220410051143-150.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022040000_202510220410051143-150.log.gz?expire=1762513628&sign=25a69db86a1473536a8a8a1c896d46bb2779287a",
                        "fileSize": 504
                    },
                    {
                        "fileName": "20251022040000_202510220405057603-151.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022040000_202510220405057603-151.log.gz?expire=1762513628&sign=bd17de6f519a9a397a8c48cc98ff7c6f0970a608",
                        "fileSize": 543
                    }
                ]
            },
            {
                "timestamp": "2025-10-22T05:00:00Z",
                "values": [
                    {
                        "fileName": "20251022050000_202510220504070533-150.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022050000_202510220504070533-150.log.gz?expire=1762513628&sign=2dda02660e26794382a79329d10c82352eeee3a3",
                        "fileSize": 613
                    },
                    {
                        "fileName": "20251022050000_202510220509038083-151.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022050000_202510220509038083-151.log.gz?expire=1762513628&sign=1bb06057020af19855014c79419bebd0666f46bd",
                        "fileSize": 394
                    }
                ]
            },
            {
                "timestamp": "2025-10-22T06:00:00Z",
                "values": [
                    {
                        "fileName": "20251022060000_202510220610039903-151.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022060000_202510220610039903-151.log.gz?expire=1762513628&sign=296bf3036dd8afaf0f0779d353ec1908722e7aef",
                        "fileSize": 536
                    },
                    {
                        "fileName": "20251022060000_202510220605051673-150.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022060000_202510220605051673-150.log.gz?expire=1762513628&sign=bfc7d0dbe58f3021360bb2063656dbeabc62327d",
                        "fileSize": 547
                    }
                ]
            },
            {
                "timestamp": "2025-10-22T07:00:00Z",
                "values": [
                    {
                        "fileName": "20251022070000_202510220704046193-151.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022070000_202510220704046193-151.log.gz?expire=1762513628&sign=80826ce95cb31248a6efd83aa6539a1020e25f79",
                        "fileSize": 490
                    },
                    {
                        "fileName": "20251022070000_202510220714044703-150.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022070000_202510220714044703-150.log.gz?expire=1762513628&sign=3d90894a0a7b75cbc5507222c49027a10c948cd4",
                        "fileSize": 578
                    }
                ]
            },
            {
                "timestamp": "2025-10-22T08:00:00Z",
                "values": [
                    {
                        "fileName": "20251022080000_202510220806165123-151.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022080000_202510220806165123-151.log.gz?expire=1762513628&sign=3a31992b23fc6ecf6152bed458bb7d234bdf9cff",
                        "fileSize": 571
                    },
                    {
                        "fileName": "20251022080000_202510220811317443-150.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022080000_202510220811317443-150.log.gz?expire=1762513628&sign=d0cffe2c5046ef99aefbb57c5756c325af4b58e6",
                        "fileSize": 436
                    }
                ]
            },
            {
                "timestamp": "2025-10-22T09:00:00Z",
                "values": [
                    {
                        "fileName": "20251022090000_202510220905041963-151.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022090000_202510220905041963-151.log.gz?expire=1762513628&sign=ce2347fc6a46345beafcb839f51e6d59315f6d5a",
                        "fileSize": 466
                    },
                    {
                        "fileName": "20251022090000_202510220910048783-150.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022090000_202510220910048783-150.log.gz?expire=1762513628&sign=ea15c9bb36e10a3d4df0c107c6a02bf618b63ee9",
                        "fileSize": 585
                    }
                ]
            },
            {
                "timestamp": "2025-10-22T10:00:00Z",
                "values": [
                    {
                        "fileName": "20251022100000_202510221023071553-150.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022100000_202510221023071553-150.log.gz?expire=1762513628&sign=b6b7210f4429826480d397647cd611cec60e814a",
                        "fileSize": 544
                    },
                    {
                        "fileName": "20251022100000_202510221008280573-151.log.gz",
                        "fileUrl": "https://cdn-dl-dev.swiftfederation.com/download/v53-gl.tiktokrow-cdn.com/20251022/20251022100000_202510221008280573-151.log.gz?expire=1762513628&sign=91faf140e4ef1ef4d57345990b1a39cf25c24d1f",
                        "fileSize": 498
                    }
                ]
            }
        ]
    }
]