1 接口描述接口地址： https://proxy.qg.net/allocate ；本接口是用于请求提取代理IP资源的；请求频率限制：按时业务是（通道数*5＋10）次/分钟；按量业务则是60次/分钟；方法：HTTP、GET，需要注意不能混合使用；编码：参数和返回内容均采用utf-8编码。 2 输入参数说明 参数名 是否必选 类型 描述 Key 是 String 申请的Key值 Num 否 Integer 申请的数量；默认1个 KeepAlive 否 Integer IP生存周期，单位：分钟。仅针对动态独享用户有效，默认为1440分钟(24小时) AreaId 否 Integer 区域ID；默认随机 ISP 否 Integer 运营商ID；默认随机 Detail 否 Integer 详情，0：关闭；1：开启；默认为0 Distinct 否 Integer 去重，仅针对动态独享有效。0：关闭；1：开启；默认为0 3 返回值接口可返回文本格式、json格式、xml格式，字段说明如下： 参数名 类型 描述 Code Integer 结果编码，0：成功；-1：失败 TaskID Integer 任务ID Num Intger 申请数量 Data Array 代理IP数据信息，包含节点IP、端口、失效日期 Msg String 区域ID，多个用”,”分割；*代表全部 4 示例请求接口示例： curl "https://proxy.qg.net/allocate?Key=请改成您的Key&Num=1" 返回示例： { "Code": 0, "TaskID": "91107E16D28AC5A", "Num": "1", "Data": [ { "IP": "127.0.0.1", "port": "49168", "deadline": "2018-05-11 02:56:02", "host": "127.0.0.1:49168" } ] } 重点：在共享企业池的产品中使用该接口，提取出来的IP资源Data结构中的host和IP是不一样的，其他产品下host和IP是一样的。企业池产品中用户使用host进行代理，这时真实的代理IP为IP字段的IP（运营商为移动的情况下可能不会那么准确，即使代理IP可能不通，也都是同一个地区的IP，影响不会大） 5 接口返回错误码 错误码 描述 -1 未知错误 -10 参数不合法 -11 请求过于频繁 -12 Authkey被封禁 -13 当前客户端IP不在授权名单中 -14 Pwd不合法 -15 Authkey对应的业务无此权限 -100 计划不存在或已过期 -103 资源不足 -104 申请资源失败 -105 申请的IP数超过允许申请的IP数

青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 步骤总览 一、API鉴权与代理授权青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作 API鉴权是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。 用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。 代理授权验证是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。 青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。 白名单设置的入口与API鉴权一样。 详细步骤可查看＞如何使用API鉴权、代理验证 二、获取api接口青果给开发者提供两种方式来获得api接口 ① 使用调试工具/提取工具 调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门＞＞调试工具 使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。 点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。 调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。 若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门＞＞提取工具 ② 查看api接口文档 除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。 点击了解API接口文档 ＞弹性提取类型、按量提取类型、均匀提取类型、通道提取类型 三、代理测试在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl} 若响应不成功，可对应错误码表，排查问题。 四、编写采集程序测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例供开发者参考， 详情查看 C语言代码示例Go语言代码示例PHP语言代码示例Python语言代码示例Java语言代码示例Shell语言代码示例C#语言代码示例Node语言代码示例 注：青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。

1 产品简介隧道代理是利用高性能主机构建的动态代理服务器，通过将切换IP的操作放到云端，自动管理用户发出的隧道请求，实现云端切换IP转发用户请求，简化用户的操作，降低了用户的时间成本； 隧道代理默认每秒允许5个并发请求限制起，支持短期高并发。 隧道代理使用简单，开发者接入隧道服务即可，参照【代码样例】可集成到您的程序中，极大简化了编程的复杂度。 2 产品优势 无须提取IP，方便快捷；采用弹性并发数控制，支持短期高并发使用；提供可视化监控统计，帮助用户精准把控请求频率走势，提升业务运行的成功率；完美匿名本机IP，避免不必要的网络攻击，提升业务成功率。云端切换IP，连接上我们的隧道代理服务器后，统一入口，随机动态出口IP，无需手动切换 ；隧道代理可用性>99%，若转发的IP不可用，隧道代理会自动再转发到1个新的可用IP，可连续使用；响应极速，毫秒级更换代理IP（访问百度测试，响应时间

1 产品简介青果的国内短效代理，提供动态和短效的IP资源，其基于拨号VPS构建的高品质代理服务器，部署全国200+城市与地区，IP日流水超600万，可用时长从1-30分钟全时段覆盖，为您的业务提供强大的支持； 选择青果短效代理，我们将为您提供多种IP资源池、IP提取方式、IP存活时长选项，您可以从中选择与业务使用最适配、最具性价比的模式进行使用。 短效代理产品的使用非常方便，只需要几分钟，您可以通过编程使用或手动设置代理IP进行使用。 2 提取方式为满足不同用户的使用需求，动态的短效代理，提供了4种不同的IP提取方式。 弹性提取：【按每天提取的IP数计费】按量提取：【按提取的IP数计费】均匀提取：【按每分钟提取的IP数计费】通道提取：【按同时在线的IP数计费】 ↑点击以上蓝字，查看该提取方式详情介绍。 不同的提取方式决定了不同计费方式，具体价格情况以购买页为准。 3 资源池短效代理为用户提供了直连池、中转池、隧道池三种IP资源池。 不同提取方式下对应有不同的资源池选择，具体见下表 短效代理 弹性提取 按量提取 均匀提取 通道提取 直连池 √ √ √ √ 中转池 √ √ √ √ 隧道池 √ *购买页中，仅通道提取保留多个资源池选项，其余提取方式将默认选中直连&中转的混合资源池。 3种IP资源池的特点为 直连池：由一些集中的宽带资源组成，IP段较为集中，所见即所得，性价比相对较高；中转池：由大量的边缘节点汇聚而成的，可选城市更多，IP段也更为分散，业务成功率更高；隧道池：资源也有分散性、边缘性特点，更突出的是免代码接入，即可实现云端自动切换IP，使用十分便利。 更详细的资源池介绍，请点击查看＞＞直连池、中转池、隧道池 4 存活时长IP存活时长是从提取到IP算起，根据购买的IP存活周期，超过存活时长IP失效。 短效代理中，提供了1分钟、2分钟、3分钟、5分钟、1-5分钟、5-15分钟和15-30分钟7种时长选项，由于资源特性不同，不同资源池&提取方式包含的选项也不同，请以具体购买页为准。 短效代理IP的到期时间均为系统自动控制，无需释放。 5 产品属性 免费白名单数量：256支持协议：HTTP/HTTPS/SOCKS5单IP最大连接数：100单IP带宽限制：2Mbps终端数限制：无限制提取资源频率：通道提取为 (通道数*5+10 ) 次/分钟，弹性/均匀/按量提取为60次/分钟单次提取IP上限：按量提取方式为200个，弹性/均匀/通道提取方式为100个 6 产品优势 IP资源池丰富，600万+纯净IP，覆盖全国主要省份3种不同特性IP资源池可选，适配不同使用需求极速（访问百度测试，响应时间

步骤总览 隧道池产品 首次提取之后，后续即会定时自动切换IP，不需要第4步重新获取哦注：若使用白名单验证模式，请先添加白名单再进行IP提取。 代理IP产品 完成购买后，即可在控制台看到相关业务信息。 后续使用代理，最重要的便是密钥信息和隧道代理的地址信息。 下面介绍手动设置 使用代理的具体步骤。 一、授权验证为保障用户使用代理的权益和安全性， 正式使用前需要进行授权验证。 青果支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的密钥信息（即图中的Authkey与Authpwd），连接代理时填入进行验证就可使用代理。 详细操作可查看代理验证 ＞ 二、提取IP确认好验证方式后，就可以开始提取IP了。 1.用户可以点击对应业务右侧的【更多】-【IP使用】-【提取IP】进入提取工具页面，也可以点击左侧导航栏的【提取工具】进入； 请注意，目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。 2.在提取工具页面，选择对应业务的Authkey，以及提取数量、地区、格式等其他选项，便可在页面下方看到链接，点击【打开链接】； 便可在打开的网页中看到此时提取到的IP地址。 三、测试使用做好以上步骤之后，即可开始连接代理测试。 青果代理IP支持用户使用各种浏览器、代理客户端、电脑系统等等进行代理设置。 以谷歌浏览器chrome为例，设置代理需要1.在右上角菜单中点击【设置】，设置页面中选择【系统】-【打开代理设置】； 2.在新打开的弹窗页面中，把【使用代理服务器】按钮打开，并填写地址与端口信息，点击保存，就算启动代理连接了； 3.若使用的是账密验证，此时在浏览器打开一个新网页，会弹出以下会话，填写业务所对应的AuthKey以及AuthPwd信息，点击确认便能完成代理连接；若使用的是白名单验证，则跳过该步骤。 4.此时进行正常的网页浏览，若能正常使用，就算代理连接成功了。 点击查看更多的浏览器、电脑系统、软件设置代理指南 ＞ 四、重新获取IP青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。（静态IP是长期固定IP，而高级版静态代理支持自主控制使用时长，详细了解） IP到期失效之后，直连池/中转池的产品需要回到第一步重新提取IP，再将新ip信息填入代理服务器中进行使用。隧道池产品 是云端定时自动切换IP的，不需要重新获取哦 了解更多产品信息，可点击以下链接↓短效代理 ＞隧道代理 ＞独享代理 ＞静态代理 ＞短效代理（全球HTTP） ＞隧道代理（全球HTTP） ＞

单日最多获取IP数量和单次最多获取数量是多少？动态IP每天可用的IP数量超过百万级，在通道数足够的情况下，短效代理通道提取方式单次最多可以申请100个IP，按量提取方式单次最多可以申请200个IP，为您的业务提供强大的助力； 静态IP最小的存活期为24小时，超过24小时后，客户可以自由地选择释放申请IP，静态IP一周只能更换2次。 IP是否支持文本提取，支持格式有哪些？目前只能通过API获取，提取格式为JSON格式和TXT文本格式，暂不支持HTML网页格式，后期会上线该功能，敬请期待哦~ 提取不到IP？提示没有剩余的可用通道数？当在申请IP时出现该提示，可通过调试工具的通道配额接口方法查看当前key的使用情况, 如果Available为0则表示当前AuthKey的可用通道数已被使用完；如果Available不为0，先到调试工具的【释放IP资源】进行通道IP的释放，再查询通道可用数。 浏览器设置代理弹出【用户名：密码】对话框，提示要输入密码出现这种问题有两种情况： （1） 白名单IP授权模式下，绑定的不是使用代理的终端IP，或者绑定的不是固定出口IP； （2）【用户名：密码】授权模式下，即使在后台绑定了终端IP授权，还是会弹出【用户名：密码】对话框的。 选择终端IP授权模式，并绑定使用代理的终端IP授权（固定出口IP），则可避免这种情况的发生。 多久可以切换IP？最长可以用多久？1.多久可以切换IP不同的代理套餐对应的IP切换时间不同，具体如下： （1）短效代理 为系统根据所对应的套餐分钟数在到期后自动进行释放，不支持人工手动释放已申请的IP； （2）独享代理 在已申请的IP地址使用时间大于30秒后才可进行释放； （3）独享代理（地区锁） IP可自主重拨，删除或释放IP需要添加线路12小时后才能执行； （4）长效代理（静态IP高级版） 在已申请的IP地址使用时间大于24小时后才可进行释放。 2.最长可以用多久？不同的代理套餐对应的IP使用时长不同，具体如下： （1）短效代理IP 受现有套餐存活期限的限制，目前单个IP最长仅支持使用30分钟； （2）独享代理IP 目前单个IP最长支持使用24小时； （3）长效代理IP 静态IP：24小时起，长期有效，不限制使用时间。 动态IP：数小时至数天，自然失效 申请IP时的生存周期KeepAlive是否可以自动释放IP？短效代理IP的释放由系统控制，无法手动释放；独享代理（地区锁）则在【IP管理】或调试工具重拨IP资源接可；独享代理申请IP过程中的KeepAlive需自行设定的IP时长，可在套餐支持的时长0-1440分钟范围内填写合适的数字，默认24小时； 长效代理IP，静态IP高级版可以手动释放IP，一周2次机会，IP需使用24小时以上可操作释放。 各套餐每天/每次最多能提取多少IP？一通道代表着并发的意思，即一通道同一时间内最多仅有一个IP。通俗的解释，相当于客户购买拨号VPS去自己搭建代理IP； 1.IP提取情况如下：（1）独享代理IP 目前的存活期存在着最小1分钟的限制，最大存活期为24小时，也就是客户最快在申请当前IP后的1分钟可以释放该IP，并且又可以马上申请新IP。假设客户每个IP仅使用最短的1分钟时间，那 么一天最多可用IP的计算公式为24×60=1440个； （2）短效代理IP 短效代理IP的存活期为系统控制，客户无法主动释放代理IP，如客户购买的是存活期1-5分钟的套餐，则其IP的存活时间为在1-5分钟内，在客户申请共享IP的时候，系统会返回其IP的deadtime（结束时间）。假设若存活时间结束后，客户马上申请新的代理IP，则其一天最多可用IP数为24×60=1440个，最小可用IP数为24×60/5=288个； （3）长效代理IP 目前长效代理分为静态和动态两种子产品，动态IP自然失效，静态IP分为普惠版和高级版，普惠版IP固定不变，高级版IP最小的存活期为1天（可手动释放），目的是防止同行或某些客户滥用资源等情况。超过1天后，客户可以自由地选择更换其他IP。但是此类客户在IP可用情况下，一般不会进行更换IP。 2.不同套餐IP的单次提取限制如下:（1）短效、静态 套餐单次可提取IP数量=剩余可用通道数，单次最多可提取100个IP； （2）短效(按量提取) 套餐单次可提取数量=剩余可用数量，单次最多可提取200个IP。

青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 步骤总览 一、API鉴权与代理授权青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作 API鉴权是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。 用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。 代理授权验证是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。 青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。 白名单设置的入口与API鉴权一样。 详细步骤可查看＞如何使用API鉴权、代理验证 二、获取api接口青果给开发者提供两种方式来获得api接口 ① 使用调试工具/提取工具 调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门＞＞调试工具 使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。 点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。 调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。 若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门＞＞提取工具 ② 查看api接口文档 除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。 点击了解API接口文档 ＞弹性提取类型、按量提取类型、均匀提取类型、通道提取类型 三、代理测试在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl} 若响应不成功，可对应错误码表，排查问题。 四、编写采集程序测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例供开发者参考， 详情查看 C语言代码示例Go语言代码示例PHP语言代码示例Python语言代码示例Java语言代码示例Shell语言代码示例C#语言代码示例Node语言代码示例 注：青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。

青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 步骤总览 一、API鉴权与代理授权青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作 API鉴权是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。 用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。 代理授权验证是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。 青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。 白名单设置的入口与API鉴权一样。 详细步骤可查看＞如何使用API鉴权、代理验证 二、获取api接口青果给开发者提供两种方式来获得api接口 ① 使用调试工具/提取工具 调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门＞＞调试工具 使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。 点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。 调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。 若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门＞＞提取工具 ② 查看api接口文档 除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。 独享代理API接口文档 ＞独享代理（地区锁）API接口文档 ＞ 三、代理测试在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl} 若响应不成功，可对应错误码表，排查问题。 四、编写采集程序测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例供开发者参考， 详情查看 C语言代码示例Go语言代码示例PHP语言代码示例Python语言代码示例Java语言代码示例Shell语言代码示例C#语言代码示例Node语言代码示例 注：青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。

青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 步骤总览 一、API鉴权与代理授权青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作 API鉴权是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。 用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。 代理授权验证是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。 青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。 白名单设置的入口与API鉴权一样。 详细步骤可查看＞如何使用API鉴权、代理验证 二、获取api接口青果给开发者提供两种方式来获得api接口 ① 使用调试工具/提取工具 调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门＞＞调试工具 使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。 点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。 调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。 若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门＞＞提取工具 ② 查看api接口文档 除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。 点击查看API接口文档 ＞ 三、代理测试在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl} 若响应不成功，可对应错误码表，排查问题。 四、编写采集程序测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例供开发者参考， 详情查看 C语言代码示例Go语言代码示例PHP语言代码示例Python语言代码示例Java语言代码示例Shell语言代码示例C#语言代码示例Node语言代码示例 注：青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。

全球HTTP均不支持在中国大陆地区网络环境下使用。青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 步骤总览 一、API鉴权与代理授权青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作 API鉴权是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。 用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。 代理授权验证是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。 青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。 白名单设置的入口与API鉴权一样。 详细步骤可查看＞如何使用API鉴权、代理验证 二、获取api接口青果给开发者提供两种方式来获得api接口 ① 使用调试工具/提取工具 调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门＞＞调试工具 使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。 点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。 调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。 若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门＞＞提取工具 ② 查看api接口文档 除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。 点击了解API接口文档 ＞按量提取类型、通道提取类型 三、代理测试在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl} 若响应不成功，可对应错误码表，排查问题。 四、编写采集程序测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例供开发者参考， 详情查看 C语言代码示例Go语言代码示例PHP语言代码示例Python语言代码示例Java语言代码示例Shell语言代码示例C#语言代码示例Node语言代码示例 注：青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。