上报云录像下载记录

开发中

POST

/v2/stats/report/streaming-record

APP上报播放记录、云录像下载记录

请求参数

Header 参数

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

X-Tg-Platform

string

必需

请求来源：android/ios/pc/web/device

默认值:

示例值:

androidiOSwebdevicepc

X-Tg-Sdk-Version

string

必需

API SDK版本号：1024

默认值:

Accept-Language

string

必需

请求端的本地语言（zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar）

默认值:

示例值:

zh-cnzh-twen-usjakoviesptrutrdeitfrplthar

X-Tg-App-Store

string

手机APP应用商店

可选

默认值:

Authorization

string

必需

服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。

默认值:

Body 参数application/json

uuid

string

设备ID

必需

start_time

number

播放开始的时间戳

必需

单位：秒

duration

number

播放时长

必需

单位：秒

data_bytes

number

产生的流量数

必需

单位：字节

p2p_mode

string

播放时P2P模式

必需

P2P(点对点)、RLY(服务器转发模式)、Download(下载云录像)等

type

string

上报类型

必需

cloud(云录像)、realtime(实时画面)、sdcard(卡录像)等

bitrate

string

码率

必需

网络流量除以时间

示例

{
    "uuid": "663CYEM5A9CG",
    "start_time": 1740042721,
    "duration": 10,
    "data_bytes": 200,
    "p2p_mode": "download",
    "type": "cloud",
    "bitrate": "40"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/stats/report/streaming-record' \
--header 'X-Tg-App-Id;' \
--header 'X-Tg-Platform;' \
--header 'X-Tg-Sdk-Version;' \
--header 'Accept-Language;' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uuid": "663CYEM5A9CG",
    "start_time": 1740042721,
    "duration": 10,
    "data_bytes": 200,
    "p2p_mode": "download",
    "type": "cloud",
    "bitrate": "40"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

示例

{
    "code": 0,
    "msg": "string"
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-03-11 09:06:12