短网址官网(mynb8.com)提供腾讯短网址API接口3.0版本。通过该接口可以生成腾讯短网址(url.cn短网址)。
更新日期:2019-11-09
腾讯短网址API-3.0版本 接口权限需要申请开通。
新注册会员免费赠送接口调用次数。
接口说明调用地址:https://www.mynb8.com/api3/urlcn.html
请求方式:GET
调用参数:
参数 | 是否必须 | 说明 |
---|---|---|
appkey | 是 | appkey是调用接口的秘钥。用户的唯一标识,在个人中心可以获得。如果还不是会员,马上注册会员 |
long_url | 是 | long_url是你需要缩短的长网址,请使用进行编码。 |
type | 否 | 返回结果有json和文本两种格式。值为 json 和 txt ,默认值:json |
请求调用说明
http请求方式: GET
https://www.mynb8.com/api3/urlcn.html?appkey=APPKEY&long_url=urlEncode(LONG_URL)
正确的json结果:
{"rs_code":0,"rs_msg":"ok","long_url":"https://mynb8.com","short_url":"https://url.cn/RIBrU9T"}
错误的json结果:{"rs_code":1000,"rs_msg":"appkey was error !"}
返回参数说明参数 | 说明 |
---|---|
rs_code | 返回码 |
rs_msg | 返回码说明 |
long_url | long_url是你需要缩短的长网址 |
short_url | 缩短后的短网址 |
PHP代码实例1:file_get_contents 方式
$appkey = 'YOUR_APPKEY'; $long_url = urlencode('https://news.baidu.com/'); $url = "http://www.mynb8.com/api3/urlcn.html?appkey=".$appkey."&long_url=".$long_url; $json = file_get_contents( $url );//接口地址不支持https $data = json_decode( $json, true); if($data['rs_code'] == 0){ $short_url = $data['short_url'];//生成的短网址 echo $short_url;exit; }else{ echo $data['rs_msg'];exit;//错误提示 }PHP代码实例2:curl 方式
$appkey = 'YOUR_APPKEY'; $long_url = urlencode('https://news.baidu.com/'); $url = "https://www.mynb8.com/api3/urlcn.html?appkey=".$appkey."&long_url=".$long_url; $json = curl_http( $url );//接口地址支持https $data = json_decode( $json, true); if($data['rs_code'] == 0){ $short_url = $data['short_url'];//生成的短网址 echo $short_url;exit; }else{ echo $data['rs_msg'];exit;//错误提示 } function curl_http($long_url){ $curlObj = curl_init(); curl_setopt($curlObj, CURLOPT_URL, $long_url); curl_setopt($curlObj, CURLOPT_RETURNTRANSFER, 1); curl_setopt($curlObj, CURLOPT_SSL_VERIFYPEER, 0); curl_setopt($curlObj, CURLOPT_HEADER, 0); curl_setopt($curlObj, CURLOPT_TIMEOUT, 20);//单位 秒,超时时间 $response = curl_exec($curlObj); curl_close($curlObj); return $response; }返回码说明
返回码 | 说明 |
---|---|
0 | 请求成功 |
1000 | appkey 参数错误 |
1001 | 其他错误 |
1002 | 接口调用限制:两次访问最少相隔0.5秒(并发量大的用户可升级vip通道接口) |
1003 | 网址必须以http或者https开头! |
1004 | 接口次数不足 |