API接口文档-神龙HTTP

属性	内容
提取IP接口	http://api.shenlongip.com/ip
方法	`GET`
编码	`utf-8`
参数说明	`key`：产品的key； `count`(可选)：提取数量, 不能超过200，默认值10； `isp`(可选)：提取IP运营商，电信、移动、联通； `pattern`(可选)：返回类型，支持txt，json； `split`(可选)：txt格式返回的分隔符。 `area`(可选)：区域编号，多个用英文逗号分隔。
异常	`code`：错误编号； `msg`：描述信息。
成功	返回内容的标签或字段类型可在产品管理里通过设置提取格式来定制；类型为txt文本的定制标签如下： `ip`：port自定义分隔符；类型为json格式的响应字段如下： `data`：[ { `ip`：IP `port`：端口 `expire`：有效时间 `city`：城市 `isp`：运营商 } ]
状态码	`200`：获取成功； `201`：请求格式不正确； `202`：单次请求数量超出最大值； `203`：请求KEY异常； `204`：套餐已过期； `205`：套餐提取数量上限； `206`：暂无可用IP； `207`：提取地区超出服务范围； `208`：提取频率太快，请稍后重试。

属性

内容

提取IP接口

http://api.shenlongip.com/ip

方法

GET

编码

utf-8

参数说明

key：产品的key；
count(可选)：提取数量, 不能超过200，默认值10；
isp(可选)：提取IP运营商，电信、移动、联通；
pattern(可选)：返回类型，支持txt，json；
split(可选)：txt格式返回的分隔符。
area(可选)：区域编号，多个用英文逗号分隔。

异常

code：错误编号；
msg：描述信息。

成功

返回内容的标签或字段类型可在产品管理里通过设置提取格式来定制；

类型为txt文本的定制标签如下：
ip：port自定义分隔符；

类型为json格式的响应字段如下：
data：[
    {
        ip：IP
        port：端口
        expire：有效时间
        city：城市
        isp：运营商
    }
]

状态码

200：获取成功；
201：请求格式不正确；
202：单次请求数量超出最大值；
203：请求KEY异常；
204：套餐已过期；
205：套餐提取数量上限；
206：暂无可用IP；
207：提取地区超出服务范围；
208：提取频率太快，请稍后重试。

属性	内容
添加白名单接口	http://api.shenlongip.com/white/add?key=xxx&sign=xxx&ip=xxx
删除白名单接口	http://api.shenlongip.com/white/delete?key=xxx&sign=xxx&ip=xxx
查询白名单接口	http://api.shenlongip.com/white/fetch?key=xxx&sign=xxx
方法	`GET`
编码	`utf-8`
参数说明	`key`：用户账号 `sign`：密钥签名 `ip`：需要添加或删除的ip地址, 多个使用','分割
异常	{ `code`：错误代码 `msg`：描述信息 }
成功	{ `code`：200 `info`：描述信息 `data`：[xxx ,xxx] // 仅查询接口返回此字段 }
状态码	`200`：操作成功 `1001`：参数有误 `1002`：ip地址格式无效 `1003`：key无效 `1004`：参数sign错误 `1005`：不是代理用户 `1006`：添加的新ip数量超过最大数量限制 `1007`：ip已存在 `1008`：ip地址不在服务范围 `1009`：白名单中不存在指定的ip可以删除 `1101`：服务器内部错误

属性

内容

添加白名单接口

http://api.shenlongip.com/white/add?key=xxx&sign=xxx&ip=xxx

删除白名单接口

http://api.shenlongip.com/white/delete?key=xxx&sign=xxx&ip=xxx

查询白名单接口

http://api.shenlongip.com/white/fetch?key=xxx&sign=xxx

方法

GET

编码

utf-8

参数说明

key：用户账号
sign：密钥签名
ip：需要添加或删除的ip地址, 多个使用','分割

异常

    {
        code：错误代码
        msg：描述信息
    }

成功

    {
        code：200
        info：描述信息
        data：[xxx ,xxx] // 仅查询接口返回此字段
    }

状态码

200：操作成功
1001：参数有误
1002：ip地址格式无效
1003：key无效
1004：参数sign错误
1005：不是代理用户
1006：添加的新ip数量超过最大数量限制
1007：ip已存在
1008：ip地址不在服务范围
1009：白名单中不存在指定的ip可以删除
1101：服务器内部错误