字段	数据类型	必填	说明
room_id	string	是	直播间id
app_id	string	是	玩法id
ack_type	int	是	上报类型，1：收到推送；2：完成处理
data	string	是	上报数据，json字符串 `[{ // 唯一标识，平台推送payload数据里的msg_id "msg_id": "xxxx", // 消息类型，如礼物为live_gift，评论为live_comment "msg_type": "xxx", // 毫秒级时间戳 // 当ack_type为1时即为收到推送的时间 // 当ack_type为2时即为完成处理后的时间 "client_time": xxxxx }]`

请求示例

curl --location --request POST 'https://webcast.bytedance.com/api/live_data/ack' \--header 'content-type: application/json' \--header 'access-token: 0801121846735352506a356a6' \--data '{
    "room_id": "78273162632",
    "app_id": "tt411d37a0dxxxxx",
    "ack_type": 1,
    "data": "[{\"msg_id\": \"32412314314\", \"msg_type\": \"live_comment\", \"client_time\": 1705989099973 }]"
}'

响应参数

字段	数据类型	说明
err_no	int	请求错误码，0表示成功，非0表示失败
err_msg	string	非0错误码时，携带额外的错误提示信息
logid	string	请求链路id, 用于出问题时提供给开平具体定位

响应示例

正常示例

{
    "err_msg": "",
    "err_no": 0,
    "logid": "xxxxx"
}

异常示例

{
    "err_msg": "status=10011 message=Request params error",
    "err_no": 1,
    "logid": "xxxx"
}

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	1	上报错误	请根据err_msg的信息排查错误