Entwicklerdokumentation für die ?ffentliche WeChat-Plattform
/ 長鏈接轉(zhuǎn)短鏈接接口
長鏈接轉(zhuǎn)短鏈接接口
長鏈接轉(zhuǎn)短鏈接接口
將一條長鏈接轉(zhuǎn)成短鏈接。
主要使用場景: 開發(fā)者用于生成二維碼的原鏈接(商品、支付二維碼等)太長導(dǎo)致掃碼速度和成功率下降,將原長鏈接通過此接口轉(zhuǎn)成短鏈接再生成二維碼將大大提升掃碼速度和成功率。
接口調(diào)用請求說明
開發(fā)者可通過OpenID來獲取用戶基本信息。請使用https協(xié)議。
http請求方式: POST
https://api.weixin.qq.com/cgi-bin/shorturl?access_token=ACCESS_TOKEN
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
action | 是 | 此處填long2short,代表長鏈接轉(zhuǎn)短鏈接 |
long_url | 是 | 需要轉(zhuǎn)換的長鏈接,支持http://、https://、weixin://wxpay 格式的url |
調(diào)用舉例
curl -d "{\"action\":\"long2short\",\"long_url\":\"http://wap.koudaitong.com/v2/showcase/goods?alias=128wi9shh&spm=h56083&redirect_count=1\"}" "https://api.weixin.qq.com/cgi-bin/shorturl?access_token=ACCESS_TOKEN"
返回說明
正常情況下,微信會返回下述JSON數(shù)據(jù)包給公眾號:
{"errcode":0,"errmsg":"ok","short_url":"http:\/\/w.url.cn\/s\/AvCo6Ih"}
參數(shù)說明
參數(shù) | 說明 |
---|---|
errcode | 錯誤碼。 |
errmsg | 錯誤信息。 |
short_url | 短鏈接。 |
錯誤時微信會返回錯誤碼等信息,JSON數(shù)據(jù)包示例如下(該示例為AppID無效錯誤):
{"errcode":40013,"errmsg":"invalid appid"}