NovaCloud-CN

批量查询播放日志概要

POST

/v2/logs/play-logs/batch-summary

提示

通过此接口批量获取播放器的播放日志概要。

一个组织用户一次只能有一个播放日志查询任务在运行中，需要等待之前的任务完成后才能继续提交新的任务。

查询的日志会以 Excel 的形式存储到我们的云空间中，并以链接形式推送给客户，请自行下载使用。

最早能查到最近3个月内的日志，最多支持查询连续30天内的日志。

Excel在我们云空间的存储周期为 7天，7天后会自动删除此文件，请在 7天内完成下载转存。

高级接口。

请求参数

Header 参数

AppKey

string

接入键

必需

默认值:

Nonce

string

必需

随机字符串（8~64个字符，仅限数字或英文字母）

CurTime

string

必需

当前 UTC 时间戳

CheckSum

string

请求签名

必需

Body 参数application/json

playerIds

array[string]

必需

需要处理的播放器ID集合。最多支持100个播放器同时处理

noticeUrl

string

必需

日志加工处理成功后，系统会回调此地址以【POST-JSON】的方式发给客户。接口的响应时间不能超过3s；客户接口必须返回 “ok” 字符串，否则系统会重试一次

startDate

string

必需

开始日期。格式如：2020-05-06（最早能查到最近3个月内的日志）

endDate

string

必需

结束日期。格式如：2020-05-12（最多支持查询连续30天内的日志）

示例

{
     "playerIds": [
        "df6c02352e4fd3cd5bc664fcdaef29c9"
    ],
    "startDate": "2024-06-01",
    "endDate": "2024-06-19",
    "noticeUrl":"http://sit-api.vnnox.com/test/noticeScreenShotUrl"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open-cn.vnnox.com/v2/logs/play-logs/batch-summary' \
--header 'AppKey;' \
--header 'Nonce;' \
--header 'CurTime;' \
--header 'CheckSum;' \
--header 'Content-Type: application/json' \
--data-raw '{
     "playerIds": [
        "df6c02352e4fd3cd5bc664fcdaef29c9"
    ],
    "startDate": "2024-06-01",
    "endDate": "2024-06-19",
    "noticeUrl":"http://sit-api.vnnox.com/test/noticeScreenShotUrl"
}'

返回响应

🟢200成功

application/json

Body

taskId

integer

此次查询任务的编号

必需

示例

{
    "taskId": "5"
}

🟢200通知客户播放日志信息回调请求参数

定时亮度调节

批量查询播放日志详情