查询视频分享结果及数据

Scope: aweme.share 不需要用户授权 该接口用获取 share_id；该接口适用于抖音。

share_id 可以用于：

  • 追踪分享的视频是否成功。
  • 获取分享视频的数据,如点赞数, 评论数等。

生成 share_id 时 need_callback 字段要传 true 才会有回调。

接入步骤：

  1. 去http://open.douyin.com/platform/business申请发布视频的能力。
  2. 分享前获取标识单次分享的share_id。
  3. 调用分享sdk时传入share_id。
  4. 基于Webhooks接收分享成功的回调信息

回调信息参数

{
  "event": "create_video",
  "from_user_id": "",
  "client_key": "",
  "msg_id": "",
  "content": {
    "share_id": "",
    "item_id": "", //加密视频ID
    "video_id": "" //真实视频ID
  }
}

item_id 可用于查询视频数据。

状态码排查

进入【状态码排查工具】

请求地址

GET /share-id/

请求头

  • Content-Type: application/json
  • access-token: 调用/oauth/client_token/生成的token，此token不需要用户授权。示例: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

请求参数

URL 请求

参数名称参数类型参数描述参数示例是否必填
暂无数据

请求样例

响应参数

参数名称参数类型参数描述参数示例
暂无数据

响应样例

{
  "extra": {
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393,
    "error_code": 0
  },
  "data": {
    "share_id": "15674132978",
    "error_code": 0,
    "description": ""
  }
}

响应错误样例

{
  "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"
  }
}
诚邀您对本文档易读易用性进行评价
好用
不好用