## 理解国外代理：它是你全球网络的钥匙 话不多说，我们先聊聊“国外代理”是什么。它的本质是一种网络技术，通过它，你的请求会先通过一个中转节点（代理服务器），看起来像是从代理IP所在的地点发出来的。而这个代理节点所在的地点呢，咱们就可以选在其他国家！ 举个例子，比如说你在上海，但需要访问洛杉矶服务器的数据资源，这时你选择一个位于洛杉矶的国外代理服务，就能够帮您顺利实现更快捷、更高效的数据访问。 而更妙的是，国外代理不仅仅是转发请求，它还能很大程度上优化访问速度，保障安全性。尤其是像青果网络这种顶级的代理服务提供商，凭借覆盖200多个城市的纯净IP池和可靠的服务，业务成功率平均高出同行业30%！ ## 国外代理缘何重要？场景告诉你答案 说到这儿，有些朋友可能会疑惑，为啥我们要用国外代理呢？我来和大家聊聊它的**应用场景**。 1. ### **优化跨国数据抓取效率** 一些大数据分析的工作，需要从各国服务器采集海量数据。国外代理大展身手，你的采集服务器能轻松应对一些跨国或者多地区的复杂任务。“青果网络”的高可用率代理，确保数据采集平稳高效。 2. ### **丰富多样的内容聚合** 有些需求需要访问海外的内容源，例如新闻整合、全球商品信息采集等，国外代理可以让您更便捷地获取所需数据。 3. ### **降低网络延迟** 选择地理位置更接近目标服务的代理，有助于更好优化网络路径，降低延迟。而“青果网络”IP网络的延迟低于100毫秒，用过的朋友都懂这是真香！ ## 如何选择靠谱的国外代理？避坑技能请收好 市面上的代理服务琳琅满目，让人眼花缭乱。别慌！我以下几点总结供参考，帮你找到靠谱的代理伙伴。 1. ### **看覆盖范围** 国外代理关键要看它的覆盖范围，能不能覆盖你所关心的国家或城市。青果网络的600万纯净IP，覆盖全球200多个城市，从北美到东欧，从亚太到中东，妥妥的全球化！ 2. ### **关注业务成功率和网络稳定性** 一次次失败的请求，谁都不想碰到对吧？业务成功率越高，说明代理的质量越好。举个例子，青果网络凭借优化后的分池技术，成功率比市场同行业高出30%！ 3. ### **IP池动态更新频率** 优质的代理服务通常会保证池内IP的纯净合法，可随时检测，过滤掉高风险IP或重复使用率过高的节点。比如“青果网络”的IP池本身就经过严格检测，IP确保可用后才开放。 4. ### **使用协议支持** 强大的代理服务商通常支持多种协议，比如HTTP、HTTPS、SOCKS5，选择覆盖范围更广的代理就能降低不兼容带来的麻烦。 5. ### **确认价格是否合理** 优质代理确实标价会稍高，但贵有贵的理由，稳定性和服务保障不会让你失望！而且像青果网络，还能提供6小时的免费测试时间，让你能试用满意了再拍板。 ## 结语 国外代理就像一把通向全球的钥匙，选好了代理，你可以高效地应对各种跨国任务。无论是大规模数据抓取，还是个人研究，找到合适的合作伙伴是关键！ 如果你还在寻找一流、可靠的国外代理服务，可以看看我们青果网络，不仅拥有广覆盖的全球IP资源，而且业务成功率比同行业产品高出30%的优势，真的帮你省钱、省力、省心！ 全球探索，其实可以如此简单。你，准备好试试了吗？

**全球HTTP均不支持在中国大陆地区网络环境下使用**。 #### 一、介绍 超级机房池，顾名思义，其IP资源来自全球各地的大型数据中心，由知名的云计算服务商控制。 目前，数据中心池IP资源覆盖了全球100+个国家地区，日去重数达400W+，拥有高质的代理服务质量，能够稳定、可靠地满足用户的各类需求。  *超级机房池IP直接表现在IP信息上的是所属ASN的type类型为business（或hosting）。 #### 二、资源池特点 相比于住宅池，超级机房池 - 由知名云厂商统一管理控制，网络更加稳定 - 性价比更高，可以根据使用的流量计费，还提供不限流量套餐选择 #### 三、适用客户群 - 追求高性价比的客户 - 不要求住宅网络，更在意稳定性的客户 [开始选用【超级机房池】套餐＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=3)

#### 单日最多获取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。

## 1 接口简介 青果代理IP提供了功能丰富的API接口，满足开发者在各种场景下的调用需求。 所有接口支持 HTTP 或者 HTTPS 请求，部分接口采用 GET 方法，部分接口采用 POST 方法；接口返回数据的格式支持文本、json、xml。 具体请参见接口文档。 ## 2 API列表 - [短效代理](https://www.qg.net/doc/2254.html) - [独享代理](https://www.qg.net/doc/2141.html) - [长效代理](https://www.qg.net/doc/2143.html) - [短效代理（全球HTTP）](https://www.qg.net/doc/2144.html) - [隧道代理相关](https://www.qg.net/doc/1940.html) ## 3 测试代理可用性 ### 3.1 生成API链接 对于代理提取API，您可以到提取工具在线生成API链接，内置到您的程序中： [提取代理API链接生成 ＞](https://www.qg.net/tools/IPget.html "提取代理API链接生成 ＞＞") 其他接口请查看API文档，获取接口url和参数说明，自己生成API链接。 ### 3.2 测试API链接 **浏览器测试** 您可以把生成的API链接直接在浏览器里打开，查看返回结果。例如，您直接点击如下api链接 https://proxy.qg.net/query?Key=0B***607 **命令行测试** 如果您在linux系统下，可以通过curl命令请求API链接查看结果： `curl "https://proxy.qg.net/allocate?Key=请改成您的Key"` ## 4 接口返回错误码 公共接口返回错误码 | 错误码 | 描述 | | ------ | ------------------------- | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | Authkey被封禁 | | -13 | 当前客户端IP不在授权名单中 | | -14 | Pwd不合法 | | -15 | Authkey对应的业务无此权限 | | -100 | 计划不存在或已过期 | | -103 | 资源不足 | | -104 | 申请资源失败 | | -105 | 释放的IP数超过允许释放的IP数 | ## 5 代码样例 查看API调用的[代码样例 ＞](https://www.qg.net/doc/172.html)

## Response 请求响应详情 被所有接口引用。 | 名称 | 类型 | 描述 | | ---------- | ------ | ------------------------------------------------------------ | | code | String | 响应[状态码](https://www.qg.net/doc/1838.html)。 | | data | Any | 请求响应数据。 | | message | String | 报错信息。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## IP 代理IP详情 被如下接口引用：[短效代理提取](https://www.qg.net/doc/1846.html), [短效代理查询](https://www.qg.net/doc/1847.html), [短效代理资源池](https://www.qg.net/doc/1850.html), [独享代理提取](https://www.qg.net/doc/1840.html), [独享代理查询](https://www.qg.net/doc/1841.html), [独享代理更换](https://www.qg.net/doc/1843.html), [长效代理提取](https://www.qg.net/doc/1863.html), [长效代理查询](https://www.qg.net/doc/1861.html)。 | 名称 | 类型 | 描述 | | -------- | ------ | ------------------------------------------------------------ | | proxy_ip | String | 代理真实出口IP地址，比如: 120.11.67.89。 | | server | String | 代理服务地址，挂代理直接使用这个字段信息，比如：120.11.67.89:8090。 | | area | String | 代理IP地区信息。 | | isp | String | 代理IP运营商信息。 | | deadline | String | 动态代理表示代理IP的存活截至时间；
长效代理表示代理IP的可释放时间。 | ## Task 单次提取详情 被如下接口引用：[短效代理提取](https://www.qg.net/doc/1846.html), [短效代理查询](https://www.qg.net/doc/1847.html), [短效代理资源池](https://www.qg.net/doc/1850.html), [独享代理提取](https://www.qg.net/doc/1840.html), [独享代理查询](https://www.qg.net/doc/1841.html), [独享代理更换](https://www.qg.net/doc/1843.html), [长效代理提取](https://www.qg.net/doc/1863.html), [长效代理查询](https://www.qg.net/doc/1861.html)。 | 名称 | 类型 | 描述 | | ------- | --------------- | ---------------- | | task_id | String | 本次提取的标识。 | | ips | Array of [IP]() | IP资源信息。 | | num | Integer | IP资源总数。 | ## Balance 余额详情 被如下接口引用：[短效代理余额查询](https://www.qg.net/doc/2256.html)。 | 名称 | 类型 | 描述 | | ------- | ------- | -------------- | | balance | Integer | 剩余资源总数。 | ## Channel 通道数详情 被如下接口引用：[短效代理通道数查询](https://www.qg.net/doc/1849.html), [独享代理通道数查询](https://www.qg.net/doc/1844.html), [长效代理通道数查询](https://www.qg.net/doc/1860.html)。 | 名称 | 类型 | 描述 | | ----- | ------- | ------------ | | total | Integer | 总通道数。 | | idle | Integer | 空闲通道数。 | ## ResourceAreaISP 资源可用地区和运营商详情 被如下接口引用：[短效代理资源地区查询](https://www.qg.net/doc/2257.html), [独享代理资源地区查询](https://www.qg.net/doc/1845.html), [长效代理资源地区查询](https://www.qg.net/doc/1859.html)。 | 名称 | 类型 | 描述 | | --------- | ------- | ---------------- | | area | String | 地区信息。 | | area_code | Integer | 地区码。 | | isp | String | 运营商信息。 | | isp_code | Integer | 运营商编码。 | | available | Bool | 是否有可用资源。 | ## Monopoly 独占资源详情 被如下接口引用：[独享代理提取](https://www.qg.net/doc/1840.html), [独享代理查询](https://www.qg.net/doc/1841.html)。 | 名称 | 类型 | 描述 | | --------------- | ------ | ------------------------------------ | | uuid | String | 资源唯一标识。 | | area | String | 地区信息。 | | isp | String | 运营商信息。 | | state | String | 资源状态。 | | ip | String | 最新IP，仅当state="在线"有值。 | | heartbeat | String | 最后一次心跳，仅当state="在线"有值。 | | monopolize_time | String | 独占的时间。 | | last_dial_time | String | 最后一次切换的时间。 | ## ResourceAreaISPWithIdle 地区和运营商可用独占资源统计 被如下接口引用：[独享代理资源地区查询](https://www.qg.net/doc/1845.html)。 | 名称 | 类型 | 描述 | | --------- | ------- | ------------ | | area | String | 地区信息。 | | area_code | Integer | 地区码。 | | isp | String | 运营商信息。 | | isp_code | Integer | 运营商编码。 | | idle | Integer | 空闲资源数。 |

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

青果隧道代理与其他形式的代理IP不同，不需要API接口即可连接使用代理IP，因此省去了获取IP和管理IP池等动作。以下介绍如何用代码方式，快速使用隧道代理。 ## 步骤总览  ## 一、获取隧道地址 1.在青果完成产品购买后，就会自动进入控制后台，看到如以下的页面，产品列中就有隧道地址；  **请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。 ## 二、授权验证 获取到隧道地址之后，还需要有授权验证才能使用代理。隧道代理支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。  详细步骤可查看[代理验证 ＞](https://www.qg.net/doc/use/8_244/1574.html) ## 三、代理测试 在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 `curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}`  若响应不成功，可对应[错误码表](https://www.qg.net/doc/1838.html)，排查问题。 ## 四、编写采集程序 测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例供开发者参考， 详情查看 - [隧道代理 Go 语言接入指南](https://www.qg.net/doc/1872.html) - [隧道代理 Python 语言接入指南](https://www.qg.net/doc/1879.html) **注：**青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。

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

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

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