请求地址

http://suoyx.com/api.htm

请求方式

GET 或 POST

输入参数字段
参数名 类型 是否必须 描述 示例值
url String 需要缩短的url,推荐使用urlencode(url)编码 https%3A%2F%2Fgithub.com%2F
domainId int 短网址域名id 入参值请参考下文的"短网址域名列表",不传入则按默认域名取
formatResult String 返回值格式,值可选json、jsonp、text,不传时返回数据为text json
callback String 回调函数名,当format=jsonp时必传
key String 登录后在"个人首页"可查看,每个用户的key都不相同 8888@56as4d6525612436
expireDate String 有效期,不传入则永久 expireDate=2019-03-31 意为2019-03-31号过后失效
password String 如果传入该值则为生成的短网址加密,不传入则不加密,长度1~20 我是密码
返回结果参数
参数名 类型 描述 示例值
code String 状态码,可能值有:SUCCESS、FAIL SUCCESS
msg String 文字提示信息 成功
data.longUrl String 原链接 https://github.com/
data.shortUrl String 短链接 http://xxx.cn/skrMbE
短网址域名列表
短网址域名id 短网址域名 默认域名
5 suo2.cn
4 vt5.cn
3 vt6.cn
2 vt7.cn
请求示例
TEXT格式
                请求: http://suoyx.com/api.htm?url=https://cn.bing.com/&formatResult=text&key=8888@56as4d6525612436
                返回:http://xxx.cn/skrMbE
            
JSON格式
                请求: http://suoyx.com/api.htm?url=https://cn.bing.com/&formatResult=json&key=8888@56as4d6525612436
                返回:{"msg":"成功","code":"SUCCESS","data":{"shortUrl":"http://xxx.cn/FFpDyx","longUrl":"https://cn.bing.com/"}}
            
JSONP格式
                请求: http://suoyx.com/api.htm?url=https://cn.bing.com/&formatResult=jsonp&callback=test&key=8888@56as4d6525612436
                返回:test({"msg":"成功","code":"SUCCESS","data":{"shortUrl":"http://xxx.cn/wIIdeW","longUrl":"https://cn.bing.com/"}})