操作步骤
1.注册流冠账号;
2.购买流量/带宽订单;
3.在『个人中心 -> 订单管理 -> 流量订单』页面查找所购买的订单,获取所需的信息,如:订单号(orderId)、密钥(secret)、密码(pwd)等;
4.编写脚本使用代理。
代理服务器地址
查看流量/带宽订单的服务地址,请在『个人中心->订单管理->查看地址端口』处点击查看;
流量订单服务http/https端口地址为:flow.hailiangip.com:14223,socks5端口地址为:flow.hailiangip.com:14224。
鉴权方式
鉴权方式为用户名和密码( username:password),使用方式如:http://username:password@flow.hailiangip.com:14223
使用方式
目前流量/带宽订单拥有三种使用方式:默认账密模式、通道账密模式和签名(sign)账密模式
1. 默认账密模式
用户名和密码
用户名(username):默认账密模式用户名为订单号(orderId),用户下单后可获取,请在『个人中心 -> 订单管理 -> 流量订单』查看
密码(password):密码需要动态生成,默认账密模式每次代理都需要根据自己的业务需求,传递不同的参数,生成方式如下
『pwd=xxxx&pid=-1&cid=-1&sip=0&uid=xxx』
默认账密模式参数
参数名称 |
类型 |
是否必填 |
说明 |
pwd |
字符串 |
是 |
流量订单密码,用户下单后可获取,请在『个人中心 -> 订单管理 -> 流量订单』查看,老订单可能没有密码,点击修改,输入新密码即可 |
pid |
数字 |
否 |
省份id,默认-1 |
cid |
数字 |
否 |
城市id,默认-1 |
sip |
数字 |
否 |
是否保持单IP,0-否,1-是,默认0 |
uid |
字符串 |
否 |
自定义,相同的UID会尽可能采用相同的IP,可以认为是同一组会话,不填表示每次请求都随机 |
优点
默认账密模式对接最便捷,只需两个参数,订单号(orderId)和密码(pwd)即可,对于小白用户很友好
2. 通道账密模式
用户名和密码
用户名(username):通道账密模式用户名为订单号(orderId),用户下单后可获取,请在『个人中心 -> 订单管理 -> 流量订单』查看
密码(password):密码需要动态生成,生成方式如下
『pwd=xxxx&zoneId=xxx』
注意:使用通道模式,需要提前到『个人中心 -> 订单管理 -> 流量订单』中添加通道信息,添加完成后,记录通道id,或者也可通过API进行添加。
通道模式参数配置
参数名称 |
类型 |
是否必填 |
说明 |
pwd |
字符串 |
是 |
流量订单密码,用户下单后可获取,请在『个人中心 -> 订单管理 -> 流量订单』查看,老订单可能没有密码,点击修改,输入新密码即可 |
zoneId |
字符串 |
是 |
通道id |
优点
通道账密模式能够使用户一个订单控制多个通道的IP。举个实际的业务场景:假如您需要启动多个浏览器,每个浏览器需要使用不同的IP,这会儿您就可以在订单上设置多个通道,给每个浏览器分配一个通道ID即可满足需求。当您需要切换IP时,可到『个人中心 -> 订单管理 -> 流量订单』的通道列表中点击切换IP,或者通过调用『添加通道API』(API操作请自行往下查看)切换即可
3. 签名(sign)账密模式
用户名和密码
用户名(username):签名账密模式用户名统一为 "proxy"
密码(password):密码需要动态生成, 生成方式如下
『orderId=xxxx&time=xxxx&sign=xxxx』
签名账密模式参数
参数名称 |
类型 |
是否必填 |
说明 |
orderId |
字符串 |
是 |
流量订单密码,用户下单后可获取,请在『个人中心 -> 订单管理 -> 流量订单』查看 |
time |
数字 |
是 |
时间戳/1000(10位时间戳,动态, 单位秒) |
sign |
字符串 |
是 |
需要通过算法生成,MD5(orderId=xxxx&secret=xxxx&time=xxxx).toLowerCase() |
secret |
字符串 |
否 |
密钥,用户下单后可获取,请在『个人中心 -> 订单管理 -> 流量订单』查看 |
pid |
数字 |
否 |
省份id,默认-1 |
uid |
字符串 |
否 |
自定义,相同的UID会尽可能采用相同的IP,可以认为是同一组会话,不填表示每次请求都随机 |
添加通道API
请求方式和地址
GET http://flow.hailiangip.com:14209/api/updateZone.do?orderId=xxx&pwd=xxx&unbindTime=60&zoneId=xxx&dik=xxx&uid=xxx&sip=0&dip=0&pid=-1&cid=-1
请求参数
参数名称 |
类型 |
是否必填 |
说明 |
orderId |
字符串 |
是 |
订单号,用户下单后可获取,请在『个人中心 -> 订单管理 -> 流量订单』查看 |
pwd |
字符串 |
是 |
流量订单密码,用户下单后可获取,请在『个人中心 -> 订单管理 -> 流量订单』查看 |
unbindTime |
数字 |
是 |
绑定时长,单位秒,60-600 |
zoneId |
字符串 |
是 |
通道id,自定义。若zoneId和上次相同,则更新上次的参数信息。长度不能超过36,且不能包含特俗字符,如:'&','!' 等 |
pid |
数字 |
否 |
省份id,默认-1 |
cid |
数字 |
否 |
城市id,默认-1 |
sip |
数字 |
否 |
是否保持单IP,0-否,1-是,默认0 |
dipExpire |
数字 |
否 |
去重时间长度,单位秒,60-86400 |
dik |
字符串 |
否 |
自定义的duplicateKey,表示该订单下,自己定义的去重关键字,同一个关键字下的请求才需求去重,不同关键字可以不去重。长度不能超过36,且不能包含特俗字符,如:'&','!' 等 |
dip |
数字 |
否 |
是否去重,0表示不去重,1表示去重,默认0 |
uid |
字符串 |
否 |
自定义,dik情况下,相同的UID会尽可能采用相同的IP,可以认为是同一组会话,不填表示每次请求都随机 |
返回内容
返回一个json对象表示成功,其他失败
返回成功示例
{"bind":true,"cid":254,"pid":22,"realIp":"27.150.192.135","uid":"default"}
返回失败示例
orderId,zoneId,pwd,unbindTime几个字段不能为空
注意
API添加通道信息是临时的,不会在官网上展示。
流量/带宽订单授权方式
代码demo不适用,可自行根据帮助编写代码
退出教程
上一步
完成
流量/带宽使用用户名,密码的方式进行授权。请通过您使用的工具、函数库来设置用户名和密码进行授权代理。
用户名:proxy
密码:密码需要动态生成, 生成算法如下。
先生成签名
orderId: 流量订单号, 用户下单后可获取, 请在『个人中心->流量订单』查看
secret: 用户密钥, 请在『个人中心->流量订单』中查看
time: 时间戳/1000(10位时间戳,动态, 单位秒)
sign = MD5(orderId=xxxx&secret=xxxx&time=xxxx).toLowerCase()
密码生成方式为:orderId=xxxx&time=xxxx&sign=xxxx
流量/带宽附加参数
附加参数主要用于业务需求, 拼接在密码串之后。
拼接示例:orderId=『订单号』&time=『当前时间戳(10位)』&sign=『sign』&pid=12&uid=5f4181143c5e24bc2598350e31744133
可选参数配置
参数名称 |
是否必填 |
说明 |
pid |
否 |
省份id |
uid |
否 |
会话ID,是指在同一个orderId下,同一个UID会固定使用同一个IP,如果不填,默认是每次请求都随机代理IP |