查询 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
content-type必填String
示例:application/json
固定值"application/json"
Body
app_id必填String
示例:tt6f31198cf00b5xxx

小程序ID

url_linkString
示例: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,用于问题快速定位

dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "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 } }

错误码

HTTP 状态码错误码错误码描述排查建议
20028005001

参数解析失败

参数解析失败

20028001003

access_token错误

重新获取access_tokenclient_token获取说明

20028005015

权限被封禁

检查权限

20028005019

url_link不存在或已失效

检查 url_link

20028005002

系统异常

重试

特殊行业类目​

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