帮助文档>代理IP>操作指南>快速入门 > 动态独享代理使用指南

动态独享代理使用指南

发布时间:2023-06-28 17:06

1 步骤说明

开发者可以通过如下4个步骤使用动态独享代理

  1. 在开通动态独享代理产品后,单击网站右上角的【控制台】,进入后台管理面板,在左侧栏目里选择【代理IP】-【按时/按量业务】,找到已经开通的动态独享代理业务;
    image-20221119161844905image-20221119161801706

  2. 在业务列表选择【操作-提取IP】,或提取工具调试工具上选择对应的key提取IP,进行本地调试和验证。

  3. 参考代码样例请求动态独享代理。

  4. 在程序中通过调用API接口获取代理,然后请求目标网站。

    1. API调用需要验证,验证方式包括密钥验证和白名单验证,根据实际使用自主选择。
    2. 密钥验证方式请求头带AuthKey和AuthPwd信息即可。
    3. 添加白名单可以免密,需要在未提取IP之前添加白名单。

2 API接口

接口类型 接口
动态独享代理 提取资源
查询资源
提取并查询资源
查询通道数
查询地区和运营商
动态独享代理(启用地区锁) 提取资源
查询资源
提取并查询资源
查询通道数
查询地区和运营商
白名单相关 添加白名单IP
删除白名单IP
查询白名单IP

3 测试代理的可用性

动态独享代理支持密钥验证和白名单两种验证方式,建议先在本机测试,测试OK后就可以正常使用了。

查看测试步骤 >

4 地区锁功能

地区锁指的是用户可以锁定地区IP进行切换,不会因为资源紧张而出现提取不到指定地区IP的情况。适合于需要使用固定地区家庭IP的场景。

启用地区锁后,提取速度会降低,使用方式也会改变。

  1. 查看地区锁启用状态:在控制台中筛选“动态独享代理”产品,可通过地区锁字段查看当前业务是否启用地区锁功能image-20230427115810055
  2. 启用或者停用地区锁:在业务列表中找到需要操作的业务,查看详情image-20230427134032050在详情页中,找到”地区锁”字段,进行启用或停用。切换地区锁功能,将强制释放已提取IP,并且12小时后才能切换地区锁。image-20230427134229110
  3. 在控制台中使用地区锁模式:在业务列表找到已启用地区锁的业务,点击“地区锁”,进入管理页面。image-20230427135104616在管理页面中,先根据购买的通道数资源,添加需要锁定的城市资源,然后在IP管理中进行切换或者移除即可。image-20230427135310848
  4. 当启用地区锁之后,所调用的API接口也会发生变化,查看详情

5 错误码一览表

HTTP返回码 说明
400 客户端错误。客户端协议无法被识别;
431 请求头过大。出现在http代理中,header头部信息过多导致;
302 出现302一般有两种情况:
1.客户端IP为海外IP,服务器会重定向到预警页面
2.客户端访问的目标站被拦截,比如银行网站、邮箱、社交软件等,服务器返回重定向到预警页面
407 授权错误,出现407一般有两种情况:
1.白名单模式,可能是用户有多出口IP,没有全部添加到白名单;或可能连接使用IP资源,是添加白名单前获取的,白名单未对其生效
2.账密模式,可能是账密信息错误
3.共享IP产品中可能是IP已过期
408 目标站不可达。服务端与目标站建连失败,服务端不可达或者当前代理IP掉线
429 请求数超出。隧道产品中用户QPS大于购买的请求数;独享和共享产品中,用户当前的代理tcp连接超出限制数
508 代理目标站为代理IP地址导致死循环。一般不出现
503 当前代理协议不支持,比如ss代理协议

6 代理请求数据统计

代理请求数据统计包括IP请求统计、IP提取明细,提供了对请求量和请求提取、使用的统计和记录。方便随时关注采集程序的运行情况,及时发现错误并修正。

同时IP请求统计还提供几种常见的错误类型分析,如请求成功、授权失败、请求数超出、连接超时等,助力数据高效采集。
image-20221108103607172

7 代码样例&SDK下载

  • 调用API

  • 代码示例

  • SDK下载 

本文导读

客户热线:4007-567-365