createQRCode

2020-02-12 16:55 更新

獲取小程序/小游戲的二維碼。該二維碼可通過(guò)任意 app 掃碼打開(kāi),能跳轉(zhuǎn)到開(kāi)發(fā)者指定的對(duì)應(yīng)字節(jié)系 app 內(nèi)拉起小程序/小游戲, 并傳入開(kāi)發(fā)者指定的參數(shù)。通過(guò)該接口生成的二維碼,永久有效,暫無(wú)數(shù)量限制。


接口地址

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


輸入

以下參數(shù)均在 JSON body 中。

名稱必填默認(rèn)值描述
access_token服務(wù)端 API 調(diào)用標(biāo)識(shí),獲取方法
appnametoutiao是打開(kāi)二維碼的字節(jié)系 app 名稱,默認(rèn)為今日頭條,取值如下表所示
path小程序/小游戲啟動(dòng)參數(shù),小程序則格式為 encode({path}?{query}),小游戲則格式為 JSON 字符串,默認(rèn)為空
width430二維碼寬度,單位 px,最小 280px,最大 1280px,默認(rèn)為 430px
line_color{"r":0,"g":0,"b":0}二維碼線條顏色,默認(rèn)為黑色
background二維碼背景顏色,默認(rèn)為透明
set_iconFALSE是否展示小程序/小游戲 icon,默認(rèn)不展示

appname的取值:

appname對(duì)應(yīng)字節(jié)系 app
toutiao今日頭條
douyin抖音
pipixia皮皮蝦
huoshan火山小視頻
?? 注意在使用該功能之前請(qǐng)記得先配置您的默認(rèn)分享文案和圖片,配置方式可參考論壇。


輸出

當(dāng)服務(wù)器端正確返回時(shí),返回圖片 Buffer。

當(dāng)服務(wù)器端無(wú)法正確返回時(shí),返回值為 JSON 形式,會(huì)返回如下信息:

名稱數(shù)據(jù)類型描述
errcodenumber錯(cuò)誤號(hào)
errmsgstring錯(cuò)誤信息

具體對(duì)應(yīng)關(guān)系為:

錯(cuò)誤號(hào)描述
0請(qǐng)求成功
-1系統(tǒng)錯(cuò)誤
40002access_token 錯(cuò)誤
40016appname 錯(cuò)誤
40021width 超過(guò)指定范圍
60003頻率限制(目前 5000 次/分鐘)
其它其它參數(shù)錯(cuò)誤


示例

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
}
?? 注意小程序的 path 要 encode 一次,如 pages%3fparam%3dtrue,小游戲的 path 為 JSON 字符串,如{"param":true},否則會(huì)導(dǎo)致取不到。


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)