抖音开放平台Logo
开发者文档
控制台

查询小程序引导卡片模板

收藏
我的收藏

接口说明

暂无

基本信息

名称描述
HTTP URL
https://open.douyin.com/api/douyin/v1/im/get_applet_template/
HTTP Method
POST
Scope
im.microapp_card
权限要求
  • 新能力上线能力实验室后,经营者可在“控制台-能力管理-能力实验室”中申请。
  • 后期能力若转为正式开放能力,可在“控制台-能力管理-互动管理”中申请。

请求参数

请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例:application/json
固定值"application/json"
Body
card_template_idString
示例:@8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==
卡片素材ID
countInt32
示例:20

每页数量,不传 card_template_id 时,该值必传,最大值为 50

cursorInt64
示例:21
分页游标
statusInt32
示例:1

卡片状态,缺省则返回所有状态的数据

  • 0:待审核
  • 1:审核通过
  • 2:审核未通过
请求示例
curl -X POST 'https://open.douyin.com/api/douyin/v1/im/get_applet_template/' -H 'Content-Type:application/json' -H 'access-token:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1' --data '{"cursor":0,"count":50}'

响应参数

Body展开全部子属性
dataStruct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "now": 1660109739, "logid": "20220810133539010174255181020C5143", "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "" }, "data": { "error_code": 0, "description": "", "has_more": false, "cursor": 0, "list": [ { "status": 1, "title": "邀请你一起打决胜巅峰匹配赛", "content": "点击加入", "card_template_id": "@72MqHzC5kqIEgB56A10R9n1psNsNe8gPbkeqQAHKbHqoQ5jL3za3OAGvMtWtnszA", "card_type": 1, "media_id": "@72MqHzC5kqIEgB56A10R9n1psNsNe8gPbkeqQAHKbHqoQ5jL3za3OAGvMt", "name": "决胜巅峰", "app_icon_url": "https://p3-developer-sign.bytemaimg.com/tos-cn-i-ke512zj2cu/a37b56ae3da84c2b98e4ad3e1ac7a1320~tplv-ke512zj2cu-144x144.jpeg?x-expires=2628437565&x-signature=kRfqYlvF17z%2FYdspB5lHAEQBzQM%3D", "create_time": 1571075129, "update_time": 1571075129 } ] } }

错误码

HTTP 状态码错误码错误码描述排查建议
20028001005
系统内部错误,请重试
请求重试,若依然无解请向平台提交反馈
20028001003
access_token无效
重新请求生成access_token
20028001008
access_token过期,请刷新或重新授权
重新请求生成access_token
20028001016
当前应用已被封禁或下线
clientKey被封禁或者下线
20028001006
网络调用错误,请重试
重试即可
20028001014
应用未授权任何能力
确认应用是否授权能力
20028001018
应用未获得该能力
开通相关能力
20028003017
quota已用完
联系平台处理
20028001019
应用该能力已被封禁
该能力被封禁,联系平台处理
20028001007
参数不合法
根据错误信息检查请求参数是否填写正常