新浪短网址

接口地址:https://api.uouin.com/app/tcn

返回格式:Json

请求方式:Http(s) Get/Post请求

请求示例:https://api.uouin.com/app/tcn?username=用户名&key=密钥&url=https://www.qq.com

接口说明:新浪官方短网址,需白名单域名方可直跳,否则会提示是否访问,白名单申请地址:https://jianye.hd.weibo.com/site/?id=2316,适合用于电商营销、短信营销等推广,请勿用于违法违规网站,否则封禁账户不退款!

请求参数说明:

参数名称必填类型说明
usernamestring用户名
keystring密钥
urlstring需要检测的URL地址

返回参数说明:

参数名称类型说明
codenumber1为生成短网址成功
msgstring系统返回提示信息!
statustring异常为false,正常为true!
countnumber点数包,如按量计费则返回!
reasonstring拦截原因,如有则返回!
describestring拦截描述,如有则返回!
urlstring检测的地址!

响应文本:

{
    "short": "http://t.cn/A6Yc9IS7",
    "statu": "true",
    "count": "463156",
    "url": "https://www.qq.com",
    "code": "1",
    "type": "tcn"
}

系统状态码参考:

 状态码code说明
 -200用户名不能空
 -201key不能空
 -202url不能为空
 -203点数包余额不足
 -204访问API频率超过套餐限制,请升级套餐
 -205请求的接口地址有误,请到API文档获取请求地址
 -206账户VIP会员没开通或已过期
 -207用户名或key不对
 -208非白名单IP,请添加白名单IP
 -209账户状态异常
 -210接口异常,查询失败
 -211账户未绑定手机号
 -212检测超时,请重试
 -213网址存在安全风险,如误报可添加白名单域名
 -214API功能未开通
 1001检测域名状态正常
 1002检测域名状态异常或封禁
 200获取数据成功
 1短网址类调用生成成功

对接代码演示:


$result = file_get_contents("https://api.uouin.com/app/tcn?username=用户名&key=密钥&url=".urlencode($url));
$json = json_decode($result,true);
if($json[code] < 0){
    echo $json[msg];// API接口异常,返回异常信息
}
if($code == 1001){
    echo "域名正常"; //判断code为1001即为正常
}
if($code == 1002){ //判断code为1002即为拦截
    echo "已被封禁";
}
//可通过sleep()或usleep()函数控制调用频率

找不到你想要的?

需要我们的帮助!
联系我们