查询 Link V2__抖音开放平台

接口说明

该接口用于查询已经生成的 link 的信息。

查询已经生成的 link 的信息，过期的 url_link 返回"url_link 不存在"。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/url_link/query_info/
HTTP Method	POST
Scope	apps.url_link.query_info
权限要求	此能力仅支持小程序通过试运营期后可用，默认获取权限，或满足指定行业类目的小程序则默认拥有权限（见文章末尾说明）

请求头

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

请求参数

Body

名称	字段类型	是否必填	示例	描述
app_id	String	是	tt6f31198cf00b5xxx	小程序ID
url_link	String	否	https://z.douyin.com/Lu86lrX	生成的url_link

请求示例

curl --location --request POST 'https://open.douyin.com/api/apps/v1/url_link/query_info/' \
--header 'Content-Type: application/json' \
--header 'access-token: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******' \
--data-raw '{
    "app_id":"tt***********",
    "url_link":"https://z.douyin.com/Lu86lrX"
}'

响应参数

Body

名称	字段类型	是否必填	示例	描述
err_msg	String	是	""	错误信息
err_no	Int32	是	0	错误码
log_id	String	是	202008121419360101980821035705926A	字节内部log_id，用于问题快速定位
data	Struct	否

响应示例

正常响应示例

{
  "err_no": 0,
  "err_msg": "",
  "log_id": "202008121419360101980821035705926A",
  "data": {
    "app_name": "douyin",
    "app_id": "tt6f31198cf00b5xxx",
    "path": "xxxx",
    "query": "xxxx",
    "create_time": 1644463984,
    "expire_time": 1644464021
  }
}

异常响应示例

{
  "err_no": 12023,
  "err_msg": "URL_Link不存在或已失效",
  "log_id": "202008121419360101980821035705926A"
}

错误码

http状态码	错误码	错误码描述	排查建议
200	28005001	参数解析失败	参数解析失败
200	28001003	access_token错误	重新获取access_token，见client_token获取说明
200	28005015	权限被封禁	检查权限
200	28005019	url_link不存在或已失效	检查 url_link
200	28005002	系统异常	重试

特殊行业类目

以下行业类目下的小程序，默认直接拥有权限

行业	服务类目
生活服务	餐饮-餐饮-餐饮门店
生活服务	餐饮-餐饮-美食团购平台
生活服务	餐饮-餐饮-外卖平台
生活服务	餐饮-餐饮-点餐平台
生活服务	餐饮-餐饮-点评与推荐
生活服务	餐饮-餐饮-菜谱
生活服务	餐饮-餐饮-餐厅排队
生活服务	生活服务-生活服务-营业性演出票务
生活服务	生活服务-生活服务-摄影/扩印
生活服务	生活服务-生活服务-搬家公司
生活服务	生活服务-生活服务-家政
生活服务	生活服务-生活服务-高空清洗
生活服务	生活服务-生活服务-月嫂/育儿嫂
生活服务	生活服务-生活服务-电路检测维修
生活服务	生活服务-生活服务-防水补漏/装修修缮
生活服务	生活服务-生活服务-燃烧器具安装/维
生活服务	酒店旅游-酒店旅游-酒店住宿
生活服务	酒店旅游-酒店旅游-景区服务
生活服务	酒店旅游-酒店旅游-酒旅平台
生活服务	零售-零售-商场百货
生活服务	零售-零售-超市/便利店
生活服务	零售-零售-品牌商
生活服务	生活服务-生活服务-休闲玩乐平台
生活服务	生活服务-生活服务-娱乐场所
生活服务	交通出行-交通出行-航空
咨询	商业服务-商业服务-法律服务
咨询	商业服务-商业服务-律师事务所
咨询	商业服务-商业服务-心理咨询
电商	电商-电商插件-任务玩法
电商	电商-电商插件-权益营销
电商	电商-电商插件-创意互动
电商	电商-电商插件-商品展示
电商	电商-电商插件-推荐导购
电商	电商-电商插件-C2B定制
电商	电商-电商插件-特殊交易
电商	电商-电商插件-线下服务/线下活动
电商	电商-电商插件-售后/其他品牌服务
线索	房地产-房地产-商品房预售
线索	房地产-房地产-房地产开发商
线索	房地产-房地产-房地产资讯
线索	房地产-房地产-房屋中介
线索	房地产-房地产-物业管理
线索	汽车-汽车-二手车
线索	汽车-汽车-汽车报价/比价
线索	汽车-汽车-养车/修车
线索	汽车-汽车-汽车资讯
线索	汽车-汽车-车展服务
线索	汽车-汽车-汽车厂商/下属子（分）公司
线索	汽车-汽车-汽车经销商/4S店
线索	商业服务-商业服务-法律服务
线索	商业服务-商业服务-律师事务所
线索	房地产-房地产-装修/建材
线索	商业服务-商业服务-招聘/求职（中介）
线索	商业服务-商业服务-第三方人力资源服务
线索	商业服务-商业服务-供应链企业

查询 Link V2在线调试

接口说明

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

​特殊行业类目​

查询 Link V2

特殊行业类目