抖音开放平台Logo
控制台

回复视频评论

更新时间 2024-07-24 11:43:46
收藏
我的收藏

接口说明

回复视频评论

使用限制

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

基本信息

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

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

请求头

名称字段类型是否必填示例描述
access-tokenString是act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/access_token/生成的token
content-typeString是application/json
固定值"application/json"

请求参数

Query

名称字段类型是否必填示例描述
open_idString是ba253642-0590-40bc-9bdf-9a1334b94059

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

Body

名称字段类型是否必填示例描述
contentString是回复内容

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

item_idString是@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' \
--header 'Content-Type: application/json' \
--header 'access-token: act.0308b91b5f4858eedd25b827fa7ed69ewKUKlr2o6b9zZOe17m4iKlMyZjJB' \
--data-raw '{
    "content": "评论",
    "item_id": "@9VwW0qOBUN9mJyD3bNxvGc791GLuPPGFOJx4rQOvLVAXbvj+60zdRmYqig357zEBXe9yX1kW9iI9RBd5IYhjRg==",
    "comment_id": "@9VwW0qOBUN9mJyD3bNxvGc791GLuP/mAOZ1yqQmlK1QQbfX460zdRmYqig357zEBlemy4tGnuHCtvx71JWmUEw=="
}'

响应参数

Body

名称字段类型是否必填示例描述

响应示例

正常响应示例

{
  "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"
  }
}

异常响应示例

{
  "data": {
    "error_code": 2100005,
    "description": "Parameter error"
  },
  "extra": {
    "error_code": 2100005,
    "description": "Parameter error",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1594015876138,
    "log_id": "2020070614111601022506808001045D59"
  }
}

错误码

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

参数不合法

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

2002100004

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

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