key:
登录查看key
复制
请求地址:http://api.3w.cn/api.htm
请求方式:GET
输入参数字段
参数名 |
类型 |
是否必须 |
描述 |
示例值 |
url |
String |
是 |
urlencode(‘链接’) |
http%3a%2f%2fwww.baidu.com |
format |
String |
否 |
调用格式,值为json或jsonp或不传,不传时返回数据为text |
|
callback |
String |
否 |
回调函数名,当format=jsonp时必传 |
|
key |
String |
是 |
登录后可以查看到,传入这个值,用户可对生成的短链接进行管理 |
|
expireDate |
String |
否 |
若expireDate为空,默认有效期3个月。若expireDate>=2040-01-01,则永久有效 |
2020-04-09或2020-04-09 18:00:00 |
domain |
String |
否 |
可选择域名。“4”代表i0k.cn;“6”代表2i.cn(付费时间满30天且未生成违规内容方可使用);“12”代表4o8.cn(付费时间满30天且未生成违规内容方可使用);“15”代表g3v.cn;“16”代表p3v.cn;。若为空,默认为g3v.cn
|
|
返回结果参数
参数名 |
类型 |
描述 |
示例值 |
code |
String |
处理结果:‘0’代表成功,‘1’代表失败 |
|
url |
String |
生成的短链接,如果生成失败,则返回原链接 |
|
err |
String |
异常描述 |
|
请求示例
- TXT 格式
-
请求:http://api.3w.cn/api.htm?url=urlencode('要缩短的网址')&key=key(登录后可见)&expireDate=yyyy-MM-dd(或yyyy-MM-dd
HH:mm:ss)&domain=0
- 实例:http://api.3w.cn/api.htm?url=http%3a%2f%2fwww.baidu.com&key=key(登录后可见)&expireDate=yyyy-MM-dd(或yyyy-MM-dd
HH:mm:ss)&domain=0
- 返回:http://b6i.cn/abcdef
- JSON 格式
-
请求:http://api.3w.cn/api.htm?format=json&url=urlencode('要缩短的网址')&key=key(登录后可见)&expireDate=yyyy-MM-dd(或yyyy-MM-dd
HH:mm:ss)&domain=0
- 实例:http://api.3w.cn/api.htm?format=json&url=http%3a%2f%2fwww.baidu.com&key=key(登录后可见)&expireDate=yyyy-MM-dd(或yyyy-MM-dd
HH:mm:ss)&domain=0
- 返回:{“code”: “0”; “url”: “http://b6i.cn/abcdef” ;“err”: “”}
- JSONP 格式
-
请求:http://api.3w.cn/api.htm?format=jsonp&url=urlencode('要缩短的网址')&callback=callbackname&key=key(登录后可见)&expireDate=yyyy-MM-dd(或yyyy-MM-dd
HH:mm:ss)&domain=0
-
示例:http://api.3w.cn/api.htm?format=jsonp&url=http%3a%2f%2fwww.baidu.com&callback=callbackname&key=key(登录后可见)&expireDate=yyyy-MM-dd(或yyyy-MM-dd
HH:mm:ss)&domain=0
- 返回:callbackname({“code”: “0”; “url” : “http://b6i.cn/abcdef” ;“err”: “”})