Shorturl API

接口使用说明
接口地址 https://api.hanada.info/qr?domain={domain}&keyword={keyword}&force={true/false}&url={url}&format={format}&margin={margin}&size={size}&err={err}
请求方式 GET
参数 domain 可选
缺省值dwz.cn
短网址域名
目前提供dwz.cn(百度提供服务)、u.nu(unu)三种短网址类型。
即可选参数为dwz.cn、u.nu
注:dwz.cn会拒绝解析未被百度收录的网址、u.nu会拒绝解析进行了重定向的网址(包括但不限于301和302重定向),若解析失败返回值为空。t.cn(新浪短网址)、url.cn(腾讯提供服务)已停止提供接口服务,本api也不再提供
keyword 可选
缺省值无
仅在domain参数为u.nu时有效,可以为域名指定对应的短网址后缀,即指定[keyword]后短网址为u.nu/[keyword]
例:https://example.com/的keyword为example,短网址为u.nu/example。
注:
  • 如果该网址已经被生成过短网址,则无法再次生成新的短网址,即此时keyword无效,返回已经被生成的短网址。
  • keyword先到先得,只能指定未被使用的keyword,若已被占用则无法再次使用,此时返回值为空(但设置了参数force情况除外)。
force 可选
缺省值false
仅在domain参数为u.nu、keyword非缺省时有效。
可选参数为true和false。
当force参数为true时,当指定keyword已被占用,仍然直接生成短网址,keyword由u.nu服务商随机生成。
当force参数为false时,当指定keyword已被占用,则返回值为空。
url 必选 用于生成短网址的原网址,需要urlencode。
format 可选
缺省值url
输出的格式
可选参数为url和qrcode。格式为url时,直接输出短网址;格式为qrcode,将短网址生成二维码图片并输出。
margin 可选
缺省值1
仅format参数为qrcode时有效,二维码白色边框尺寸等级
可选参数为1-10。参数越高,边框越宽。
size 可选
缺省值300
仅format参数为qrcode时有效,二维码图片尺寸。
若缺省则根据容错级别和尺寸等级自动指定。
err 可选
缺省值M
仅format参数为qrcode时有效,容错级别(errorLevel)。
容错率越高越容易被识别,但图片复杂度也会相应提高,可选参数如下:
     L         7%
     M       15%
     Q        25%
     H        30%
示例 dwz.cn https://api.hanada.info/shorturl?domain=dwz.cn&format=url&url=https%3a%2f%2fwww.baidu.com%2f
https://api.hanada.info/shorturl?domain=dwz.cn&format=qrcode&url=https%3a%2f%2fwww.baidu.com%2f
u.nu https://api.hanada.info/shorturl?domain=u.nu&keyword=1-&force=false&format=url&url=https%3a%2f%2fwww.baidu.com%2f
https://api.hanada.info/shorturl?domain=u.nu&keyword=1-&force=false&format=qrcode&url=https%3a%2f%2fwww.baidu.com%2f
响应 dwz.cn https://dwz.cn/OP1YJchI
u.nu https://u.nu/baidu123