流程说明
1.注册充值;
2.添加白名单;
3.提取IP;
4.设置并使用代理;
5.查看计费/使用次数。
签名验证
流冠代理开放API会对每个访问请求进行身份验证,既每个请求都需要包含签名信息(sign),签名是由订单Id、订单secret、时间戳等组成。每个订单都有一个唯一的secret,订单secret相当于API调用的密码,一定要严格保密谨防泄漏。以下是签名验证的详细过程:
       1、在个人中心的订单管理中获取订单Id和订单密钥;
       2、按照如下顺序将对应字段信息进行拼接:orderId+secret+系统时间戳(精确到秒),例如:
Id=O20156532,secret=Adsresdgxg15sdg21yt,时间戳=1645754222,则拼接后到字符串为:
orderId=O20156532&secret=Adsresdgxg15sdg21yt&time=1645754222
       3、对拼接后的字符串进行MD5加密处理,加密处理完后将字符串转小写即可,即完整的签名步骤为:sign=MD5(orderId=O20156532&secret=Adsresdgxg15sdg21yt&time=1645754222).toLowerCase()
添加白名单接口 addWhiteIp接口
http://api.hailiangip.com:8422/api/addWhiteIp?orderId=&time=&sign=&ip=
参数名称 |
含义 |
是否必填 |
范围 |
ip |
需要添加的白名单IP地址 |
是 |
|
orderId |
绑定的订单号 |
是 |
请查看自己的订单号 |
time |
时间戳/1000 |
是 |
用于保证即使您的请求被人拦截了,也仅能有1个小时的时效 时间戳/1000 |
sign |
校验串,用于校验使用者权限 |
是 |
请查看自己的secretKey和校验串生成算法 |
删除白名单接口 delWhiteIp接口
http://api.hailiangip.com:8422/api/delWhiteIp?orderId=&time=&sign=&ip=
参数名称 |
含义 |
是否必填 |
范围 |
ip |
需要删除的白名单IP地址 |
是 |
|
orderId |
绑定的订单号 |
是 |
请查看自己的订单号 |
time |
时间戳/1000 |
是 |
用于保证即使您的请求被人拦截了,也仅能有1个小时的时效 时间戳/1000 |
sign |
校验串,用于校验使用者权限 |
是 |
请查看自己的secretKey和校验串生成算法 |
获取隧道代理IP列表接口 getIp
http://api.hailiangip.com:8422/api/getIp?type=&num=&pid=&cid=&orderId=&time=&sign=&dataType=&singleIp=
接口说明
1. 本接口的作用是获取基于隧道技术的代理IP地址和端口
2. 如果填写了sign参数和time参数,并且校验通过,则会自动添加当前使用的IP到白名单。
3. 自动切换IP能够提高请求的成功率,但是如果业务不允许自动切换,请设置成singleIp=1
请求参数(请注意大小写)
参数名称 |
含义 |
是否必填 |
范围 |
orderId |
需要绑定的订单号 |
是 |
请查看自己的订单号 |
time |
时间戳/1000,和sign一起使用 |
否 |
用于保证即使您的请求被人拦截了,也仅能有1个小时的时效 时间戳/1000 |
sign |
校验串,如果有校验串,会自动加上当前访问的IP地址到白名单,如果没有校验串,会检查IP白名单 |
否 |
请查看自己的secretKey和校验串生成算法 |
num |
提取数量 |
否 |
1-200 |
type |
IP协议类型 |
否 |
1 HTTP/HTTPS 2 SOCKS |
pid |
所需省份 |
否 |
0~30 ,不填默认全国详细请对照省份清单表 |
cid |
所需城市 |
否 |
参照城市清单表,不填默认全国或全省 |
dataType |
返回数据格式 |
否 |
0 json 1 txt 2 html 不填默认0 |
singleIp |
当正在使用中的IP掉线时,是否自动切 换别的IP地址 |
0自动切换,既可以不保持单独的IP 1 不自动切换,既必须保持单独IP默认为0,自动切换IP |
|
unbindTime |
绑定时长 |
否 |
绑定时长,单位秒,可选值 60、180、300、600、900、 1800,不填默认60 |
noDuplicate |
去重标记 |
否 |
0:不去重,1:24小时去重,不填默认0 |
响应格式
Code表示返回码,0成功,其他失败
Msg表示错误信息,成功为空,其他的描述原因;错误码和错误类型请参照错误码表
serialNo:返回的流水号,通过此流水号可以进行解绑
Data表示返回数据,内容为多个ip+port
{
serialNo:54687632a1s3d5f46assd321
code:0,
msg:"",
data:[
{ip:”111.111.111.111”,port:7890},
{ip:”111.111.111.111”,port:7891}
]
}