缩链短链接短网址API是由缩链短链接官方发布的用于将长链接转换为短链接的API。它可以缩短长链接并生成/xxx格式的短链接。
协议:http/https
请求路径:http://api.suolink.cn/api.htm
请求方式:GET
申请调用接口时分配的接口授权密钥,代表用户调用接口时的唯一身份。url_long和link后面的url是需要转换的长链接。如果你的url有参数或者特殊符号,需要进行URLencoded,否则参数可能会丢失。
申请钥匙的步骤
1、回车,选择API接口。
2、创建唯一用户id后进入界面管理控制台。
3、获取接口授权密钥长链接短链接转换,是请求接口的唯一标识。
4、复制API接口地址,可以调用生成短链接。
参数名 | 类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
url | String | 是 | urlencode(‘链接’) | http%3a%2f%2fwww.baidu.com |
format | String | 否 | 调用格式,值为json或jsonp或不传,不传时返回数据为text | |
callback | String | 否 | 回调函数名,当format=jsonp时必传 | |
key | String | 是 | 传入该值,可对生成的短网址进行管理,key值格式:开发者ID@开发者密钥 | |
expireDate | String | 是 | 例:expireDate=2030-03-31 | |
domain | String | 是 | 独享域名 |
接口说明
1、在线使用
上面提到的两个接口都是公共接口,不需要授权密钥就可以正常调用。如果要在线使用,只需要将url_long和link后面的url替换成需要转换的长链接,然后复制完整的接口地址到浏览器即可。打开以生成短链接。
2、请求接口
对于需求量大的,建议直接访问接口,请求接口生成短链接。
返回结果参数
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
url | String | 生成的短网址,如果生成失败,则返回原链接 | http://suolink.cn/abcdefg |
err | String | 异常描述 | 无异常该字段为空 |
接口请求示例
1、PHP 请求示例:
$url = 'http://www.baidu.com';
$api_url = 'http://lnurl.cn/sina/short-api?url_long=http://www.baidu.com;
$short_url = file_get_contents($api_url);
echo $short_url;
2、Java 请求示例:
public static void main(String path[]) throws Exception {
URL u = new URL(“http://lnurl.cn/sina/short-api?url_long=http://www.baidu.com”);
InputStream in = u.openStream();
ByteArrayOutputStream out = new ByteArrayOutputStream();
try {
byte buf[] = new byte[1024];
int read = 0;
while ((read = in .read(buf)) > 0) {
out.write(buf, 0, read);}
} finally {
if ( in != null) {
in .close();
}
}
byte b[] = out.toByteArray();
System.out.println(new String(b, “utf-8”));
}
3、Python 请求示例:
import urllib, urllib2, sys
host = 'http://lnurl.cn'
path = '/sina/short-api'
method = 'GET'
querys = 'url_long=http%3A%2F%2Fwww.baidu.com'
bodys = {}
url = host + path + '?' + querys
request = urllib2.Request(url)
response = urllib2.urlopen(request)
content = response.read()
if (content):
print(content)
预防措施:
1、
-
调用API时,只需将 “http://www.baidu.com”换成需要缩短的长网址即可
2、
-
接口支持长链接中带参数,但要注意的是当你的长链接中出现 & 符号时,请用 %26 代替(或者使用url编码),否则参数可能会丢失
3、
-
填写链接时,必须要以http(s)://开头,否则可能会导致生成失败或者生成的短链接无法访问原网站
常见问题:
1、为什么长链接转换后尾部参数丢失?
A:由于长链接中包含特殊字符,使用接口生成前需要对URL进行编码。
2、接口没有返回结果,是什么情况?
答:有时接口返回数据会有延迟。如果超时不返回,则生成失败长链接短链接转换,不返回结果;或者原来的链接被屏蔽了。
3、生成的短链接有效期是多久?访问次数有限制吗?
A:缩链短链接生成的短链接是永久有效的长链接短链接转换,点击次数没有限制分享:最新的长链接到短链接API和完整的细节,可以放心使用。
更多API调用说明,请登录缩链官方网站后点击控制台-工具列表-API接口自行查看.