简要描述

短网址，顾名思义就是一种较短域名加动态参数组成的短地址，类似于t.cn/xxxx，url.cn/xxx。是由各大平台诸如新浪、腾讯、百度发布的短网址接口将长网址转换而来的。

应用场景

短网址的应用场景很广，譬如短信营销、邮件推广、微信营销、QQ营销、自媒体推广、渠道推广等，都会用到短网址。
究其原因是在于短网址可以降低推广成本、用户记忆成本，提高用户点击率；在特定的场景下推广还能规避关键词，防止域名被拦截，隐藏真实地址等。

短网址生成接口

1、新浪最新官方接口

http://lnurl.cn/tcn-api.json?key=hd3j2ryt&url=http://www.baidu.com


2、腾讯最新官方接口

http://lnurl.cn/url-api.json?key=a1yl3piu&url=http://www.baidu.com

接口文档

1、请求方式

  • POST 


2、请求参数

参数 必选 类型 说明
KEY 是 string 登录获取


3、参数说明

上文提到的接口API是官方发布的公开接口，均可以直接使用，无需获取授权Key。但有请求次数限制，超出限制，接口会返回“user dose not have resource to register long term short url”。

无限制接口是需要注册获取授权Key，Key是请求接口时用来鉴别企业或者个人的唯一身份。用来做鉴权使用，请勿随意泄露。


4、获取授权KEY

1、进入 http://lnurl.cn/，选择立即开通接口。

2、注册创建唯一用户id后前往接口管理控制台。

3、获取接口授权KEY和请求地址，KEY就是请求接口的唯一识别。

4、复制整串API地址，就可以请求生成了。


5、请求说明

① 在线使用

只需将 “http://www.baidu.com” 换成需要缩短的长网址（要带http(s)://），然后复制整串链接前往浏览器打开即可生成。

② 请求接口

请求接口自动生成，需要接入程序中，PHP、Java、Python相关请求示例如下。


6、请求示例

PHP请求示例：

$url = 'http://www.baidu.com';  $api\_url = 'http://lnurl.cn/tcn-api.json?key=hd3j2ryt&url=http://www.baidu.com;  $short\_url = file\_get\_contents($api\_url);  
echo $short\_url;  


Java请求示例：

public static void main(String path\[\]) throws Exception { 
URL u = new URL("http://lnurl.cn/tcn-api.json?key=hd3j2ryt&url=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"));  
}  


Python请求示例：

import urllib, urllib2, sys  
host = 'http://lnurl.cn'  path = '/tcn-api.json?key=hd3j2ryt'  method = 'GET'  
querys = 'link=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、请求接口时，需做urlencode处理，否则可能会导致参数丢失，短网址失败等。

2、请求接口的长网址必须要以http(s)://开头。

3、接口请求频率不能太快，正常1次/s。

常见问题：

1、长网址转换后，为什么参数丢失了？

答：因为没有做urlencode处理，导致某些特殊字符没有识别到。需要将url编码后再请求接口。

2、请求接口为什么没有返回结果？

答：有些时候接口返回数据有延迟，就会导致超时未返回。或者是因为原链接被封了。

3、生成的短网址有效期是多久？有没有访问次数限制？

答：共享接口生成的短网址是有有效期的，正式版的接口生成的所有短网址都是永久有效的。

4、短网址有没有访问限制？

此接口为新浪和腾讯官方接口，是不限制访问次数的，可以放心使用。

原文转载自： http://lnurl.cn/1txjc5.html