NovaCloud-CN

获取播放器运行状态

POST

/v2/player/current/online-status

提示

通过此接口获取播放器当前状态（在线、离线）、播放器类型、屏体尺寸、系统版本、IP地址等信息。

子账号只能获取到本工作组以及子工作组的数据。

基础接口。

请求参数

Header 参数

AppKey

string

接入键

必需

默认值:

Nonce

string

必需

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

CurTime

string

必需

当前 UTC 时间戳

CheckSum

string

请求签名

必需

Body 参数application/json

playerIds

array[string]

必需

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

playerSns

array[string]

必需

需要处理的播放器SN集合,最多支持100个播放器同时处理，与playerIds必选一个参数

示例

{
    "playerIds": [
        "8208967d40e9980bab6d12367dc88e0b"
    ]
}
或者
{
    "playerSns": [
        "2KKA02B12N0A10000151"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open-cn.vnnox.com/v2/player/current/online-status' \
--header 'AppKey;' \
--header 'Nonce;' \
--header 'CurTime;' \
--header 'CheckSum;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "playerIds": [
        "8208967d40e9980bab6d12367dc88e0b"
    ]
}
或者
{
    "playerSns": [
        "2KKA02B12N0A10000151"
    ]
}'

返回响应

🟢200成功

application/json

Body

playerId

string

播放器ID

必需

string

必需

播放器唯一标识。如果为null代表没有绑定播放器

onlineStatus

integer

必需

播放器当前在线状态。0-离线，1-在线

lastOnlineTime

string

必需

播放器最后心跳时间(new)

示例

[
  {
    "playerId": "130c0a9f4cd9f2c9d421a97b0293e5d6",
    "sn": "BZSA07216J0550000373",
    "onlineStatus": 1,
    "lastOnlineTime": "2020-09-09 14:48:50"
  }
]

修改于 2024-08-07 01:35:02

获取播放器列表

获取播放器配置状态