跳转至

优质代理

API 代理问答Link

1、API链接提取格式Link

API就是url链接,用户的程序需要支持API的读取,定期从url中获取代理IP的相关信息,其格式如下:

默认文本分隔符为回车换行 \r\n

122.4.51.173:23401
182.32.13.201:23918
113.121.24.20:23373
122.5.41.167:24616
58.56.5.161:33575

自定义分隔符
在链接后面加上 &part=分隔符 ,分隔符需要使用url转义(定义之后生成的链接,复制使用)

手动

json格式(在API链接后面加上&format=json,返回JSON格式)

格式说明

  • status: 是否成功[bool]
  • proxy: 代理列表[list]
  • msg: 信息[object]
  • error_msg: 错误信息[object]
  • ip: 代理IP
  • port: 代理端口
  • remote_ip: 访问目标网站真实IP

{
  "status": true,
  "proxy": [
    {
      "ip": "113.120.29.24",
      "port": 25369,
      "remote_ip": "113.120.29.24"
    },
    {
      "ip": "113.120.35.113",
      "port": 29755,
      "remote_ip": "113.120.35.113"
    }
  ]
} 

详细格式需要通知客服开启,提取方式是在API提取链接后面加上“ &format=json” 能够获取到代理公网IP(json元素=remote_ip)所属省、地市信息:

格式说明

  • ip:代理IP
  • port:代理端口
  • remote_ip:访问目标网站真实IP
  • ttl:可用(秒)
  • switch:切换IP(秒)
  • ttl-abs:可用(1970年至今: 秒)
  • switch-abs:切换IP(1970年至今: 秒)
  • state:省份
  • city:城市

 {
   "ip": "182.31.21.199", 
   "port": 22585, 
   "remote_ip": "182.31.21.199"
   "ttl": 1155.5463411808014,    
   "switch-abs": 1637901158.07836, 
   "ttl-abs": 1637901158.07836,
   "switch": 1155.5463411808014,        
   "state": "山东", 
   "city": "济南", 
   "city-code": 370600, 
   "state-code": 370000, 
}

中state是省,city是市。

2、API访问速度限制Link

在代理提取时间内只能访问一次API链接,超出的访问网站会返回 429 Too Many Requests 。 因此出现429之后,程序需要暂停等待,直到下一次代理提取时间到期再访问; 否则程序大量快速访问,网站可能会判断为攻击,直接黑名单禁止访问

3、IP白名单修改方式Link

登录后台,后台查看 “当前代理” ,点击 修改白名单 的图标 ,即刻生效。 修改IP

如果客户的服务器是动态IP(家庭网络,VPS拨号)等非固定IP的网络情况下,需要登录后台启用“自动更新ip”,系统将自动绑定计算机的外网ip。 修改IP详细

注意

1) 白名单IP数量小于授权IP数量,添加当前访问IP到白名单末尾。

2) 白名单IP数量超过授权IP数量,替换白名单中最不常用IP,如白名单中多个IP未使用,则替换位置最后一个。

平台支持通过API动态修改或替换IP白名单,后台查看 “当前代理”, “获取API链接” 有详细说明。

4、API链接访问,出现错误提示如何处理?Link

一般出现以下3种错误提示:

(1)False,您的IP***:没在白名单(***)中,请登录系统修改, 客服 QQ:1294609932

以上情况是由于IP白名单错误导致,请客户登陆后台设置IP白名单(参考上面3、IP白名单修改方式)。如果客户的服务器网络是移动、长宽或多个网络出口请联系客服咨询。

(2)False,您没有访问该链接的权限,客服 QQ:1294609932

以上情况是由于API链接错误导致,请客户重新刷新后台页面(禁止点击“重新生成”按钮)复制API链接使用。如果服务器的操作系统是Linux,API链接必须进行转义, &符号前面要加\,方可使用。

(3)False,没有获取到任何代理,速率超过限制 , 客服 QQ:1294609932

以上情况是因为API链接的请求频率超过所开产品的限制,请按照产品的要求控制API的访问频率即可。

5、为什么有大量重复IPLink

  • 直接统计API提取的代理IP进行去重是不准确的,因为部分地区为保证网络速度、降低网络延迟,提供的代理为IP隧道代理,该代理是通过专线固定IP+随机端口,在一个时间点上随机分配一个外网IP(又称:公网IP)。
  • 如果要做外网IP去重,可以通过json提取代理信息(通知客服开启)。提取方式是在API提取链接后面加上“ &format=json”,这样能同时获取代理IP和当前对应的外网IP(remote_ip字段) ,请用remote_ip做去重(该字段只能做去重统计,不能直接使用),格式如图:
 # 代理IP 
 "ip": "113.120.29.24"  
 # 代理端口 
 "port": 25369        
 # 访问目标网站真实IP(仅用于统计,不能直接使用) 
 "remote_ip": "113.120.29.24" 

通过json提取代理(通知客服开启),提取方式是在API提取链接后面加上“ &format=json”,能够获取到代理IP有效时间。 代理IP有两种类型:外网模式和IP隧道模式;

  • 如果元素ip和remote_ip是一样的,则是外网模式;如果元素ip和remote_ip不一样,则IP隧道模式。

  • 外网模式下的提取元素ttl作为有效时间(秒);IP隧道模式由于产品特性,请按照2分钟有效时间管理。

7、代理提取失败或提取之后大量代理访问失败Link

由于私密家庭代理提取和使用都需要绑定IP白名单, 因此必须确保提取和使用代理的服务器, 其IP白名单都添加到后台;同时由于移动、手机热点、铁通、鹏博士、长宽是互联网多出口动态分配特性,导致出口IP随机变化, 也会出现代理提取失败或访问失败,需要具备电信、联通、各类云服务器或固定IP等网络。

8、一台机器多条代理或一条网络下多台机器,经常提取失败Link

一条代理API链接只能按照指定时间间隔进行访问,注意程序是不是有多个线程访问或一个服务器下有多个软件运行, 超出了代理链接提取速度,请用浏览器访问代理API链接,看看中文提示错误描述。 果服务器每秒请求超过一次,会被判断为DDOS攻击行为,直接黑名单处理,停止该行为一段时间后会自动恢复访问许可。

9、代理IP请求出现大量错误Link

请统计下HTTP状态码,如果大量429,需控制每个代理IP的请求数(使用线程)。 每条线路是多个用户共享的,每条线路运营商都有上限,自动运维系统会做IP失效检测, 现IP阻塞就会返回429避免IP失效。

10、代理开通和续费Link

后台点击“订单记录”,找到对应订单信息,然后点击“支付”或“续费”,如图: 续费

代理到期前才能自助续费。否则需联系客服开通续费,以便厂家进行业务独享管理。

11、每秒提取和分发模式Link

为了给服务器集群或多线程软件提供更快的API响应速度,平台提供分发模式,

在代理API链接后面加上&dist=[数量],可以实现每秒快速多次请求,每次获取相应数量的代理IP。

例如:API&dist=1,表示每次提取1个IP。需要注意的问题是:

(1) 分发模式并不能增加单位时间内的代理IP提取总量,例如动态短效代理,标准产品是每分钟提取50个代理IP,

分发模式快速提取超出每分钟50个代理IP的总量,会导致访问返回429 Too Many Requests ,客户可以增加该订单的代理IP提取量避免上述情况。

(2) 分发模式是基于服务器缓存机制,代理IP有效时间会相应缩短,因此代理IP要尽快提取使用,否则可能出现ip失效的情况。

12、服务器IP不是固定IP,经常变化咋办?Link

  • 自动更新IP

    系统提供自动更新IP功能,适合通过API链接提取代理IP的服务器,当该服务器访问API链接的时候,平台会自动分析来源IP地址,如果出现变化会自动更新。详细说明请点击订单的“获取API链接”->“修改白名单”。

  • API接口更新IP

    系统提供API命令接口对IP白名单进行修改,可以查询、添加、替换、修改IP白名单,详细说明请点击订单的“获取API链接”->“白名单修改”。

  • 其它说明

    (1)服务器部署于家庭宽带、VPS动态拨号的情况下,需要登录后台勾选启用“自动更新IP” (云服务器等固定IP不能开启),系统将自动绑定计算机的外网IP。并且可以通过后台观察那些IP白名单是不常用的,在IP白名单自动更新的过程中,这些IP将被优先替换,如果IP白名单有多个,更换期间可能出现提取失败的情况,需要等待1-6分钟白名单全部更新完成即可,程序需要做好API提取请求频率控制和异常处理。

    (2)只有一台机器访问API链接提取,其它机器都是共享使用代理IP的情况下,如果服务器IP地址出现变化,需要使用API命令接口对IP白名单进行获取、添加、替换和修改,同时平台提供demo程序示例可以直接参考使用,详情请咨询客服免费获取。

13、API产品的按时计费和按量计费有什么区别,应该如何选择?Link

按时计费产品适合数据采集量比较平均,程序可以稳定平均请求的业务。按量计费适合每天业务的高峰期与低谷期都比较明显,程序需要随时动态调整采集频率的业务。

14、 按量计费的方式,有效期到期后IP还未用完应该如何处理?Link

有效期到期之后订单失效,代理IP将不能再提取使用。订单持续续费代理IP量将会累加不会丢失,有效期也会累加。

15、缓存提取和IP更新频率的区别?Link

  1. 缓存提取”是指单位时间内提供相同的代理IP用于快速访问。
  2. “IP更新频率”是指获取新代理IP的时间间隔。

本产品提供秒级的缓存机制,支持客户端按秒访问提取API链接,但是每次提取的IP是重复的,只有按照产品的IP更新频率才能提取到新的代理IP。“缓存提取”功能默认开启并可以通知客服关闭。 以“动态混拨-按时计费”产品为例,其参数为:

提取方式:支持秒级缓存提取;

IP更新频率:每10秒更新15 IP;

其表现为支持每秒提取一次15个代理IP,10秒以内都是重复代理IP,每10秒更新提取新的代理IP。

16、API产品的主要区别Link

产品 验证方式 请求速度 联通率 计费方式 IP池规模
动态混拨 IP白名单 >98% 按时/按量 一般
优质代理 IP白名单 >98% 按时/按量 较大
定制代理 IP白名单 >90% 按量 较大