简要描述
短网址,顾名思义就是一种较短域名加动态参数组成的短地址,类似于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、短网址有没有访问限制?
此接口为新浪和腾讯官方接口,是不限制访问次数的,可以放心使用。