抖音开放平台Logo
开发者文档
控制台

回复视频评论

收藏
我的收藏

接口说明

回复视频评论

使用限制

  1. 图集目前不支持评论
  2. 若发评人是私密账号,所有视频类型的评论以及相机拍摄的图评在端上都不会展示
  3. 该接口只能回复授权用户自己发布的视频

基本信息

名称描述
HTTP URL
https://open.douyin.com/item/comment/reply/
HTTP Method
POST
Scope
item.comment
权限要求

需要申请权限 需要用户授权 路径:抖音开放平台控制台 > 应用详情 > 能力管理 > 互动权限

请求参数

请求头
access-token必填String
示例:act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例:application/json
固定值"application/json"
Query
device_brand必填String
示例:apple
设备品牌
device_platform必填String
示例:iphone
设备平台
device_type必填String
示例:iPhone13.2
设备类型
ip必填String
示例:127.0.0.1
客户端ip地址(不要传服务端ip,避免影响生产业务)
open_id必填String
示例:ba253642-0590-40bc-9bdf-9a1334b94059

通过/oauth/access_token/获取,用户唯一标志

os_version必填String
示例:14.5
操作系统版本号
shark_channel必填String
示例:open_api
通过具体某种渠道发起的请求,例sdk/h5/open_api/system/in_imp/others
Body
content必填String
示例:回复内容

评论的具体内容,按字符串长度不能超过100

item_id必填String
示例:@8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==
视频id
comment_idString
示例:@kj5k4hai123d22nGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==

若需要对评论进行回复,则需要传评论id,来源于接收评论回复事件

请求示例
curl --location --request POST 'https://open.douyin.com/item/comment/reply/?open_id=43eae150-12eb-4035-8d40-3f9a2bfcdf4e&device_brand=Apple&device_platform=iphone&device_type=iPhone13%2C2&ip=36.110.186.142&os_version=17.6.1&shark_channel=sdk' \ --header 'Content-Type: application/json' \ --header 'access-token: act.0308b91b5f4858eedd25b827fa7ed69ewKUKlr2o6b9zZOe17m4iKlMyZjJB' \ --data-raw '{ "content": "评论", "item_id": "@9VwW0qOBUN9mJyD3bNxvGc791GLuPPGFOJx4rQOvLVAXbvj+60zdRmYqig357zEBXe9yX1kW9iI9RBd5IYhjRg==", "comment_id": "@9VwW0qOBUN9mJyD3bNxvGc791GLuP/mAOZ1yqQmlK1QQbfX460zdRmYqig357zEBlemy4tGnuHCtvx71JWmUEw==" }'

响应参数

Body展开全部子属性
dataStruct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "sub_error_code": 0, "sub_description": "", "logid": "202008121419360101980821035705926A", "now": 1597213176393, "error_code": 0, "description": "" }, "data": { "error_code": 0, "description": "", "comment_id": "@kj5k4hai123d22nGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==", "avatar": "https://uuue/ehdne", "nick_name": "xiaoming" } }

错误码

HTTP 状态码错误码错误码描述排查建议
2002100005

参数不合法

自查接口入参类型和取值是否符合规范

2002100004

系统繁忙,此时请开发者稍后再试

重试后不能解决,提开放平台oncall处理