评论回复列表__抖音开放平台

接口说明

获取评论回复列表

使用限制

注意参数中 item_id 作为 url 参数时，必须 encode，只对 item_id 单独进行 encode
注意参数中 comment_id 作为 url 参数时，必须 encode，只对 comment_id 单独进行 encode

基本信息

名称	描述
HTTP URL	https://open.douyin.com/item/comment/reply/list/
HTTP Method	GET
Scope	item.comment
权限要求	需要申请权限需要用户授权申请路径：移动、网站应用控制台-互动权限-管理视频评论

请求头

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

请求参数

Query

名称	字段类型	是否必填	示例	描述
comment_id	String	是	%409VwW0qOBUN9mJyD3bNxvGc791GzgOPqBPZZyoA%2BlKVcaZ%2FP860zdRmYqig357zEBTPAmauvAUsItTqnHsp%2BcJw%3D%3D	encode后的评论id
count	Int32	是	10	每页的数量，最大不超过20，最小不低于1
item_id	String	是	%409VwWjvGUTp9kKW%2Bma4huFs791GfuOPuEM5RzrQOuKFAUZ%2Ff660zdRmYqig357zEBoG9CZ3tmAj%2F%2Bzx3ynAUaVA%3D%3D	encode后的视频id
open_id	String	是	ba253642-0590-40bc-9bdf-9a1334b94059	通过/oauth/access_token/获取，用户唯一标志
cursor	Int64	否	0	分页游标, 第一页请求cursor是0, response中会返回下一页请求用到的cursor, 同时response还会返回has_more来表明是否有更多的数据。
sort_type	String	否	time	列表排序方式，不传默认按推荐序，可选值：time(时间逆序)、time_asc(时间顺序)

请求示例

curl --location --request GET 'https://open.douyin.com/item/comment/reply/list/?open_id=ec1aa301-641b-4fcd-970c-8b0804c6dd01&cursor=0&count=20&item_id=%409VwW0qOBUN9mJyD3bNxvGc791GzvNPCLPp11oQqvKlMbaPL960zdRmYqig357zEBr7zwUvKC669aK5%2BVMO3qvw%3D%3D&comment_id=%409VwW0qOBUN9mJyD3bNxvGc791GzgOPqBPZZyoA%2BlKVcaZ%2FP860zdRmYqig357zEBTPAmauvAUsItTqnHsp%2BcJw%3D%3D&sort_type=time' \
--header 'Content-Type: application/json' \
--header 'access-token: act.ccfc55d2ac4f4e42d3585b5cc5bec0bbkmrhJe4IKBggGtvCzEpmwccGsl0Q' \

响应参数

Body

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

响应示例

正常响应示例

{
  "extra": {
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393,
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": ""
  },
  "data": {
    "error_code": 0,
    "description": "",
    "cursor": 1,
    "has_more": true,
    "list": [
      {
        "create_time": 1607399832,
        "digg_count": 647,
        "reply_comment_total": 12,
        "top": true,
        "comment_id": "",
        "comment_user_id": "",
        "content": "回复内容",
        "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状态码	错误码	错误码描述	排查建议
200	2100005	参数不合法	自查接口入参类型和取值是否符合规范
200	21000004	系统繁忙，此时请开发者稍后再试	重试后不能解决，提开放平台oncall处理

评论回复列表在线调试

接口说明

使用限制

基本信息

请求头

请求参数

Query

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

评论回复列表