问题描述:createQRCode
获取小程序/小游戏的二维码。该二维码可通过任意app扫码打开,能跳转到开发者指定的对应字节系app内拉起小程序/小游戏, 并传入开发者指定的参数。通过该接口生成的二维码,永久有效,暂无数量限制。
接口地址
POST https://developer.toutiao.com/api/apps/qrcode
输入
以下参数均在JSON body中。
名称必填默认值描述access_token
是服务端API调用标识,获取方法appname
否toutiao是打开二维码的字节系app名称,默认为今日头条,取值如下表所示path
否小程序/小游戏启动参数,小程序则格式为encode({path}?{query}),小游戏则格式为JSON字符串,默认为空width
否430二维码宽度,单位px,最小280px,最大1280px,默认为430pxline_color
否{“r”:0,“g”:0,“b”:0}二维码线条颜色,默认为黑色background
否二维码背景颜色,默认为透明set_icon
否FALSE是否展示小程序/小游戏icon,默认不展示
appname的取值:
appname对应字节系apptoutiao
今日头条douyin
抖音pipixia
皮皮虾huoshan
火山小视频
⚠️ 注意
在使用该功能之前请记得先配置您的默认分享文案和图片,配置方式可参考论坛。
输出
当服务器端正确返回时,返回图片Buffer。
当服务器端无法正确返回时,返回值为JSON形式,会返回如下信息:
名称数据类型描述errcodenumber
错误号errmsgstring
错误信息
具体对应关系为:
错误号描述0
请求成功-1
系统错误40002
access_token错误40016
appname错误40021
width超过指定范围60003
频率限制(目前5000次/分钟)其它
其它参数错误
示例
body示例如下:
{
"appname": "toutiao",
"access_token": "XXX",
"path": "",
"width": 430,
"line_color": {"r": 0, "g": 0, "b": 0},
"background": {"r": 255, "g": 255, "b": 255},
"set_icon": true
}
报错截图、相关bug:
{
"errcode": 40002,
"errmsg": "bad access_token"
}
复现步骤:完全按照官方文档提示数据格式post请求获取二维码的接口,但是一直提示bad access_token,可以确定access_token没有问题,这个access_token用来支付和敏感信息检测都是ok的。只有调用这个接口不行,请问到底是什么原因呢?
联系方式: