长链转短链接口停止生成短链说明

2021年03月15日后将停止该接口生成短链能力,点击查看原公告


将一条长链接转成短链接。

主要使用场景: 开发者用于生成二维码的原链接(商品、支付二维码等)太长导致扫码速度和成功率下降,将原长链接通过此接口转成短链接再生成二维码将大大提升扫码速度和成功率。

接口调用请求说明

开发者可通过OpenID来获取用户基本信息。请使用https协议。

http请求方式: POST https://api.weixin.qq.com/cgi-bin/shorturl?access_token=ACCESS_TOKEN

参数说明

参数 是否必须 说明
access_token 调用接口凭证
action 此处填long2short,代表长链接转短链接
long_url 需要转换的长链接,支持http://、https://、weixin://wxpay 格式的url

调用举例

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数据包给公众号:(2021年3月15日后停止短链生成,short_url返回原始long_url

{"errcode":0,"errmsg":"ok","short_url":"http:\/\/w.url.cn\/s\/AvCo6Ih"}

参数说明

参数 说明
errcode 错误码。
errmsg 错误信息。
short_url 短链接。目前短链接域名为w.url.cn,自2020年10月24日起,短链接域名将升级为新域名mmbizurl.cn,原有w.url.cn域名仍可以正常访问。

错误时微信会返回错误码等信息,JSON数据包示例如下(该示例为AppID无效错误):

{"errcode":40013,"errmsg":"invalid appid"}

其他说明

接口测试号生成的短链接在用户访问后数分钟内会失效,仅限测试使用,请勿用于生产环境