第三方平台
第三方平台概述
创建第三方平台
接口说明
常见问题排查指南

获取小程序码

获取授权小程序的二维码。该二维码可通过任意 app 扫码打开,能跳转到开发者指定的对应字节系 app 内拉起小程序, 并传入开发者指定的参数。通过该接口生成的二维码,永久有效,暂无数量限制。

请求地址

POST   https://developer.toutiao.com/api/apps/qrcode

 

Body 参数(json)

参数名参数类型是否必须默认值备注
access_tokenstring授权小程序的接口调用令牌
appnamestringtoutiao打开二维码的字节系 app 名称,默认为今日头条,取值如下表所示
pathstring小程序启动参数,格式为 encode({path}?{query}),默认为空
widthint430二维码宽度,单位 px,最小 280px,最大 1280px,默认为 430px
line_colorobject{"r":0,"g":0,"b":0}二维码线条颜色,默认为黑色
backgroundobject{"r":255,"g":255,"b":255}二维码背景颜色,默认为白色
set_iconboolfalse是否展示小程序/小游戏 icon,默认不展示

appname 的取值

appname对应字节系 app
toutiao今日头条
douyin抖音
pipixia皮皮虾
huoshan火山小视频

Body 参数示例

{
  "access_token": "XXX",
  "appname": "toutiao",
  "path": "",
  "width": 430,
  "line_color": { "r": 0, "g": 0, "b": 0 },
  "background": { "r": 255, "g": 255, "b": 255 },
  "set_icon": true
}

 

返回值

正确情况下返回图像的字节流,响应 header 中包含

HTTP/1.1 200 OK

Content-Type: image/png

返回值示例

{
  "errcode": 40002,
  "errmsg": "bad access_token"
}

错误码

错误码message
-1系统错误
40002access_token 错误
40016appname 错误
40021width 超过指定范围
60003频率限制(目前 5000 次/分钟)

 

Bug & Tip

  • Tip:小程序的 path 要 encode 一次,如 pages%3fparam%3dtrue,否则会导致取不到。
  • Tip:在使用该功能之前请记得先配置您的默认分享文案和图片。
点击纠错
评价此篇文档