获取 open_ticket

我的收藏

Scope: open.get.ticket 需要申请权限不需要用户授权该接口用于 h5 链接拉起抖音发布器分享视频时对开发者身份进行验签；本接口适用于抖音。

注意

抖音的OAuth API以https://open.douyin.com/开头
open_ticket的有效时间为2个小时，重复获取ticket后会使上次的ticket失效(但有5分钟的缓冲时间)

请求地址

GET /open/getticket/

请求头

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

请求参数

无

请求样例

curl --location --request GET 'https://open.douyin.com/open/getticket/' \
--header 'access-token: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxGFs' \

响应参数

参数名称	参数类型	参数描述	参数示例
extra	struct
logId	string	标识请求的唯一id	202008121419360101980821035705926A
now	i64	毫秒级时间戳	1597213176393
error_code	i32	错误码	0
description	string	错误码描述
sub_error_code	i32	子错误码	0
sub_error_description	string	子错误码描述
data	struct
ticket	string	open_ticket接口调用凭证	@bxLdikRXVbTPdHSM05e5u5sUoXNKd8==
expires_in	i64	open_ticket超时时间，单位秒	7200

响应样例

{
  "extra": {
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393,
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": ""
  },
  "data": {
    "error_code": 0,
    "description": "",
    "expires_in": 7200,
    "ticket": "@haihdoibxLdikRXVbTPdHSM05e5u5sUoXNKd8=="
  }
}

响应错误样例

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

错误码

错误码	描述	排查建议
2100004	"系统繁忙，此时请开发者稍后再试"	检查参数或重试
2190004	“无权访问”	申请该应用权限
2190005	"ticket已过期"	ticket有效时间7200s，在获取ticket前必须生成ticket
16388	“签名不正确”	确认获取的ticket与校验的ticket是否一致

下一篇：移动/网站应用文档指引