接入文档

蚂蚁防红支持两种接口模式,防红链接生成和域名状态检测接口,两种接口提交地址和参数分别不同,请注意提交的API接口。

接口约定

1. 数据编码统一为 utf-8。

2. 该文档中提到的 uid token,可在用户中心查看。

3. 对于有数据返回的接口,格式为 json,结构如下:

                      
                                        {
                                        code: xxx,     //1 0 为返回接口,999为服务器异常
                                        msg: {}    //当 code=1 or 0 时,content为接口返回内容。否则为错误信息
                                        }
                                    
                                    

4. 对于有数据提交的接口,统一用 post/get 的方式(查询接口除外)。数据格式为:

1. 域名状态检测接口

接口地址:

http://abcd.hxjztx.cn/CheckUrl

请求方式:

post/get

请求参数:

参数名 含义 验证 类型 说明
uid 用户uid 必填 int(12) 用户唯一标识,注册后可在用户中心,接口信息栏查看。
token 用户token 必填 var(32) 发起API必须传入参数,验证用户
type 检测类型 必填 tinyint(2) 1为检测微信 2为检测QQ
chkurl 检测网址 必填 var(64) 必须带上协议头,如http:// or https://
用户 token 非常重要,一定不要显示在任何网页代码、网址参数中。只可以放在服务端,以免发生意外的安全风险。

返回示例:

                      
                                        {
                                        code:  1,
                                        msg: "检测域名状态正常"
                                        }
                                    
                                    
code 状态 0 为域名被拉结 1 为域名状态正常 2 为账号异常 如次数超限 999 为系统出错 msg 则返回出错信息

2. 防红短链接生成接口

接口地址:

http://abcd.hxjztx.cn/ShortUrl

请求方式:

post/get

请求参数:

参数名 含义 验证 类型 说明
uid 用户uid 必填 int(12) 用户唯一标识,注册后可在用户中心,接口信息栏查看。
token 用户token 必填 var(32) 发起API必须传入参数,验证用户
type 短网址类型 必填 tinyint(2) 短网址类型:1-新浪,2-百度,3-搜狗,4-微信
longurl 防红网址 必填 var(64) 必须带上协议头,如http:// or https://
title 网站标题 必填 var(64) 直链打开时的标题
用户 token 非常重要,一定不要显示在任何网页代码、网址参数中。只可以放在服务端,以免发生意外的安全风险。

返回示例:

                      
                                {
                                code:  1,
                                msg: "检测域名状态正常"
                                shorturl: "https://w.url.cn/s/AzoQhRp"
                                }
                            
                            
code 状态 0 为域名被拉黑or其他 1 为生成成功 999 为系统出错 msg 则返回出错信息 shorturl 为返回防红链接