W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
獲取小程序/小游戲的二維碼。該二維碼可通過(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í),獲取方法 | |
appname | 否 | toutiao | 是打開(kāi)二維碼的字節(jié)系 app 名稱,默認(rèn)為今日頭條,取值如下表所示 |
path | 否 | 小程序/小游戲啟動(dòng)參數(shù),小程序則格式為 encode({path}?{query}),小游戲則格式為 JSON 字符串,默認(rèn)為空 | |
width | 否 | 430 | 二維碼寬度,單位 px,最小 280px,最大 1280px,默認(rèn)為 430px |
line_color | 否 | {"r":0,"g":0,"b":0} | 二維碼線條顏色,默認(rèn)為黑色 |
background | 否 | 二維碼背景顏色,默認(rèn)為透明 | |
set_icon | 否 | FALSE | 是否展示小程序/小游戲 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ù)類型 | 描述 |
---|---|---|
errcode | number | 錯(cuò)誤號(hào) |
errmsg | string | 錯(cuò)誤信息 |
具體對(duì)應(yīng)關(guān)系為:
錯(cuò)誤號(hào) | 描述 |
---|---|
0 | 請(qǐng)求成功 |
-1 | 系統(tǒng)錯(cuò)誤 |
40002 | access_token 錯(cuò)誤 |
40016 | appname 錯(cuò)誤 |
40021 | width 超過(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)致取不到。
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: