直播间跳转链接获取

我的收藏

该接口用于快速跳转直播间的链接或二维码。

使用限制

无

接口说明

接口返回的schema字段可以直接扫码拉起抖音
入参中的过期时间为生产短链的过期时间，实际跳转同样会受直播间状态的影响。
open_id与account字段至少要传入一个用于指定主播，同时传入时会选用open_id。请注意open_id与client token的对应关系

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/douyin/v1/schema/get_live/
HTTP Method	POST
Scope	jump.basic
权限要求	此接口jump.basic权限默认开通需要应用鉴权

请求头

名称	类型	必填	描述
content-type	string	是	固定值 "application/json"
access-token	string	是	调用`/oauth/client_token/`生成的 token，此 token 不需要用户授权。示例：`clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******`

响应参数

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

暂无数据

## 请求示例

curl --location 'https://open.douyin.com/api/douyin/v1/schema/get_live/' \
--header 'access-token: clt.e3331253187dc9dff97fa99a3f694f2dCEDejXkOxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "expire_at": 1684116049,
    "open_id": "ba253642-0590-40bc-9bdf-9a1334b94059"
}'

响应参数

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

暂无数据

响应示例

正常示例

{
  "data": {
    "schema": "snssdk1128://webview?url=https%3A%2F%2Fopen.douyin.com%2Fplatform%2Foauth%2Fslink%2F%3Ftoken%3D3f88af29866b5e15e0cd70390181d2d9d2a7%26client_key%3Dawr8bfr64vxgk036"
  },
  "err_msg": "",
  "err_no": 0,
  "log_id": "2023030419213553F1D75DDEBBF96B037B"
}

异常示例

{
  "err_no": -1,
  "err_msg": "系统错误",
  "log_id": "20220919151647010174244209010DE6B6"
}

错误码

HTTP 状态码	错误码	描述	排查建议
200	28001003	access_token无效	检查access_token是否正确有效
200	28001007	参数不合法	查看传参是否正确，如过期时间是否符合范围

上一篇：视频详情页跳转链接获取

下一篇：创建投稿任务