流程說明
1.注冊充值;
2.添加白名單;
3.提取IP;
4.設置并使用代理;
5.查看計費/使用次數(shù)。
簽名驗證
流冠代理開放API會對每個訪問請求進行身份驗證,既每個請求都需要包含簽名信息(sign),簽名是由訂單Id、訂單secret、時間戳等組成。每個訂單都有一個唯一的secret,訂單secret相當于API調用的密碼,一定要嚴格保密謹防泄漏。以下是簽名驗證的詳細過程:
       1、在個人中心的訂單管理中獲取訂單Id和訂單密鑰;
       2、按照如下順序將對應字段信息進行拼接:orderId+secret+系統(tǒng)時間戳(精確到秒),例如:
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=
參數(shù)名稱 |
含義 |
是否必填 |
范圍 |
ip |
需要添加的白名單IP地址 |
是 |
|
orderId |
綁定的訂單號 |
是 |
請查看自己的訂單號 |
time |
時間戳/1000 |
是 |
用于保證即使您的請求被人攔截了,也僅能有1個小時的時效 時間戳/1000 |
sign |
校驗串,用于校驗使用者權限 |
是 |
請查看自己的secretKey和校驗串生成算法 |
刪除白名單接口 delWhiteIp接口
http://api.hailiangip.com:8422/api/delWhiteIp?orderId=&time=&sign=&ip=
參數(shù)名稱 |
含義 |
是否必填 |
范圍 |
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參數(shù)和time參數(shù),并且校驗通過,則會自動添加當前使用的IP到白名單。
3. 自動切換IP能夠提高請求的成功率,但是如果業(yè)務不允許自動切換,請設置成singleIp=1
請求參數(shù)(請注意大小寫)
參數(shù)名稱 |
含義 |
是否必填 |
范圍 |
orderId |
需要綁定的訂單號 |
是 |
請查看自己的訂單號 |
time |
時間戳/1000,和sign一起使用 |
否 |
用于保證即使您的請求被人攔截了,也僅能有1個小時的時效 時間戳/1000 |
sign |
校驗串,如果有校驗串,會自動加上當前訪問的IP地址到白名單,如果沒有校驗串,會檢查IP白名單 |
否 |
請查看自己的secretKey和校驗串生成算法 |
num |
提取數(shù)量 |
否 |
1-200 |
type |
IP協(xié)議類型 |
否 |
1 HTTP/HTTPS 2 SOCKS |
pid |
所需省份 |
否 |
0~30 ,不填默認全國詳細請對照省份清單表 |
cid |
所需城市 |
否 |
參照城市清單表,不填默認全國或全省 |
dataType |
返回數(shù)據(jù)格式 |
否 |
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表示返回數(shù)據(jù),內容為多個ip+port
{
serialNo:54687632a1s3d5f46assd321
code:0,
msg:"",
data:[
{ip:”111.111.111.111”,port:7890},
{ip:”111.111.111.111”,port:7891}
]
}