HTTP代理开发文档
本站采用的编码格式为GBK格式,所有返回信息均为GBK格式
使用HTTP进行程序设计时的建议:
1. 使用API获取IP时:
1.1 判断返回是否正确,套餐是否到期,访问是否频繁等。参考”code返回信息”中的 code:1, code:3001, code:3002, code:3003
1.2 判断返回的代理IP的数量。根据返回代理IP的数量,创建对应数量线程,或分配给指定线程
1.3 可根据需要,判断代理的连通情况,ping值,以及本地去重等操作
1.4 在获取IP时,建议增加合适的延时
2. 使用代理访问站点时:
1.1 建议根据实际测试,确定代理超时值。
1.2 建议根据自己测试,确定站点返回内容所代表的含义。例如:IP是否被屏蔽,是否需要提交cook,协议头等
1.3 建议根据实际测试,确定访问频率,访问次数等。
1.4 在设置HTTP代理时,建议将https设置成http。例如
proxy_host='125.17.84.25:22022'
proxy = {
'http': 'http://'+proxy_host,
'https': 'http://'+proxy_host,
}
1.5 由于https和http的协议不同,建议优先使用http访问。例如:
使用代理访问http://www.ip138.com/,会比使用代理访问https://www.ip138.com/,返回速度更快
一.API请求参数说明:
例如:http://http.9vps.com/getip.asp?username=用户名&pwd=API密码&geshi=1&fenge=1&fengefu=&getnum=20
参数 | 必填 | 类型 | 值 | 说明 |
username | 是 | string |
| 用户名 |
pwd | 是 | string |
| API密码 |
geshi | 是 | string | 1:TXT格式 2:JSON格式 | 返回HTTP代理的格式 |
fenge | 是 | string | 1:回车换行(\r\n) 2:回车(\r) 3:换行(\n) 4:TAB(\t) | 用于多个HTTP代理之间的分割符 一般使用fenge=1 |
getnum | 是 | number | 1 | 每次提取数量 |
Contenttype | 否 | string | 1:(GBK) 2:(UTF8) | 返回信息中,中文的编码格式,默认:GBK |
fengefu | 否 | string | 根据情况设置 | 需要使用url编码 例如:#应编码为%23,@应为%40 |
二.响应字段 (JSON)信息说明:
字段 | 说明 | |
ip | 代理IP ( 使用代理时请使用这个IP ) | |
port | 代理端口 ( 使用代理时请使用这个端口 ) | |
endtime | IP到期时间。例:2022/7/6 19:17:40 到此时间后,该代理IP不可用
| |
Num | 获取到的HTTP代理数量 | |
code | 提示代码!详见code返回信息 | |
msg | 提示信息!例:error!用户名或密码错误 | |
success | 返回状态! false,true
|
三.提交白名单API接口
例如:
http://www.9vps.com/httpip/upwhiteipapi.asp?username=用户名&apipwd=API密码串&comment1=1.1.1.1<br>2.2.2.2<br>
接口地址:http://www.9vps.com/httpip/upwhiteipapi.asp
Username:您的用户名
comment1:您要提交的所有白名单IP地址 (每个IP之间用<br>分割)
Apipwd:本条HTTP代理的密码(即api中的pwd值 )
apipwd获取方法(登录用户中心-->HTTP代理-->API生成-->选择API-->API生成)
四.code返回信息说明:
code返回值 | 说明 | |
"code":0 | 成功 | |
"code":1 | API访问时,速度过快 | |
"code":3001 | “msg”:”error!该套餐已过期!” “msg”:”error!该套餐可使用次数已用完!” | |
"code":3002 | “msg”:”error!用户名或密码错误” | |
"code":3003 | “msg”:”error!username不能为空” | |
"code":10001 | “msg”:”非法IP,请添加白名单IP地址!massage:error IP,Please add whitelist!err:10002!” 常见于: 1:用户在不同IP地址下,使用同一个API。 解决方法:将您所在的所有IP地址,添加到该API的白名单下 2:用户长时间未使用此条API 解决方法: (1):将您所在的IP地址,添加到该API的白名单下 (2):手动获取一下API,一般10秒后,IP会自动添加到白名单中 | |
"code":10002 | “msg”:”错误的可用时长套餐!massage:error time product!err:10002!” 常见于: 1. 在同一个IP地址下,有多个时长套餐使用 2. 在1-3分钟的白名单IP地址下,却使用3-5分钟时效的HTTP代理 停止其中一个时长套餐,等待几分钟即可 | |
"code":10003 | “msg”:”访问太频繁!get too often!err:10003!” 常见于: 1.使用同一个HTTP代理地址,访问太频繁,疑似攻击 | |
"code":4001 | “msg”:”IP白名单更新失败!至少保留一个IP白名单” 增加IP白名单时,提交的IP是空值 | |
"code":4002 | “msg”:”IP格式错误” 提交IP白名单时,提交的ip地址格式不对 | |
"code":4003 | “msg”:”过期产品无法更改” 该HTTP代理套餐已过期,请续费 | |
"code":4004 | “msg”:”本API最多支持x条白名单,如需增加,请购买” |
扣费说明
1:不限量套餐,在购买的时效内,不限制提取次数。到期自动停止
2:计次套餐,提取不扣费,使用才扣除数量。
特别说明
计次套餐规则
1:计次套餐扣费,按照提取API时的IP作为标准。
2:同时有计次套餐和不限量套餐的用户,如果在同一IP下同时使用,优先扣除计次套餐次数!建议两个套餐不要在同一IP下同时使用
3:多条计次套餐API,在同一IP下同时使用,默认优先扣除到期时间最短的API数量。