短效代理（全球HTTP）开发者指南
全球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会失效。
独享代理开发者指南
青果为有经验的开发者提供多种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会失效。
长效代理-使用指南-手动版
步骤总览
完成购买后，即可在控制台看到相关业务信息。
后续使用代理，最重要的便是密钥信息（隧道代理使用的是地址信息）。
下面介绍手动设置 使用代理的具体步骤。
一、授权验证为保障用户使用代理的权益和安全性， 正式使用前需要进行授权验证。
青果支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器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使用24小时起，1周最多释放2次。【动作指引】：用户可在调试工具页面进行释放IP的操作。释放成功后，即可重新获取IP。
动态类型产品，IP是自然失效的，失效后IP将自动释放，用户需要回到第一步重新提取IP，再将新ip信息填入代理服务器中进行使用。另外，动态长效产品升级了隧道转发功能——可在IP失效释放后，自动连接新IP，省去重新提取IP的步骤，用户可根据需求选择附加功能。
短效代理（全球HTTP）-使用指南-手动版
全球HTTP均不支持在中国大陆地区网络环境下使用。
代理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连接代理就能成功；
账密模式，即先获取该代理业务的密钥信息（即图中的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，不需要第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的，不需要重新获取哦
长效代理-产品介绍
1 产品简介长效代理是以高性能云主机为主，一手散段IP资源为辅建设的高品质代理服务器，青果除了为客户提供可以长期持有的静态IP之外，还有多种存活时长(1天以上)、可动态切换的长效IP资源。
【静态类型】：普惠版与高级版，普惠版的IP是长期不变的，独享带宽高稳定性。而高级版特别提供了自主更换IP的功能，一周可自主更换2次。
【动态类型】：IP存活时长为数小时到数天范围内自然失效，有低带宽和高带宽套餐可选。且可附加隧道转发功能，IP失效之后将自动连接新IP（未勾选隧道功能的，需重新提取IP）。
长效代理使用非常方便，只需几分钟，您就可以通过API链接获取代理IP并参照代码样例集成到您的程序中。
2 产品优势
IP时长可控，自主释放，可用时长从24小时到365天全覆盖，满足多场景需求；真实IP地址，IP稳定性强；提供丰富的API接口，调用方便快捷。IP真实，全年7x24小时稳定可用静态类型独享带宽和IP，稳定性强极速（访问百度测试，响应时间
隧道代理（全球HTTP）-产品介绍
1 产品简介全球HTTP均不支持在中国大陆地区网络环境下使用
隧道代理（全球HTTP）是利用高性能主机构建的动态代理服务器，通过将切换IP的操作放到云端，自动管理用户发出的隧道请求，实现云端自动切换IP转发用户请求，简化用户的操作，降低了用户的时间成本；
隧道代理使用简单，开发者接入隧道服务即可，参照 代码样例 可集成到您的程序中，极大简化了编程的复杂度。
2 资源池隧道代理产品为用户提供了超级机房池、住宅池两种IP资源池选择。
超级机房池：覆盖全球100+国家地区，IP集中管理更加稳定，性价比高。住宅池：覆盖全球200+国家地区，日去重数大1000W+，拥有更高的业务成功率。
更详细的资源池介绍，请点击查看＞＞超级机房池、住宅池
3 付费模式超级机房池提供按流量和按请求数两种计费模式。住宅池资源目前都按使用流量付费。
4IP存活时长每一个请求随机一个IP。
5 产品优势
无须提取IP，方便快捷；支持高并发，不限制并发请求数量提供可视化监控统计，帮助用户精准把控请求频率和请求流量走势，提升业务运行的成功率；完美匿名本机IP，避免不必要的网络攻击，提升业务成功率。云端切换IP，连接上我们的隧道代理服务器后，统一入口，随机动态出口IP，无需手动切换 ；隧道代理可用性>99%，若转发的IP不可用，隧道代理会自动再转发到1个新的可用IP，可连续使用；同时支持Http/Https和Socks协议；响应极速，毫秒级更换代理IP（访问百度测试，响应时间
短效代理（全球HTTP）-产品介绍
1 产品简介全球HTTP均不支持在中国大陆地区网络环境下使用。短效代理（全球HTTP）提供全球100+个国家地区的海量IP资源，日去重量达到400万+。为您提供高质、可靠、稳定的代理服务，适用于公开数据采集的场景，助力企业融入数字经济发展浪潮。
在青果强大的技术支撑下，支持客户使用HTTP、HTTPS、Socks5 三大协议，多种语言脚本，保证您快速连接。
短效代理（全球HTTP）为用户提供了通道提取和按量提取两种方式，您可以从中选择适合自己业务的模式。
全球短效代理产品的使用非常方便，只需要几分钟，您可以通过编程使用或手动设置代理IP进行使用。
2 提取方式为满足不同用户的使用需求，全球HTTP-短效代理提供了2种不同的IP提取方式。
按量提取：【按使用的流数计费】适合流量使用不固定的应用场景通道提取：【按同时在线的IP数计费】适用于对流量使用量较大的应用场景
↑点击以上蓝字，查看该提取方式详情介绍（包含对应的套餐/IP存活时长介绍）。
不同的提取方式决定了不同计费方式，具体价格情况以购买页为准。
3 产品优势
存活周期丰富，通道提取可选5-60分钟，按量提取可选1-3分钟，灵活适配用户需求；支持高并发，不限制并发请求数量；完美匿名本机IP，避免不必要的网络攻击，提升业务成功率。可用性>99%，设置中转IP，保障可连续使用；支持账密&白名单两种鉴权方式，白名单IP最多支持256个；极速（访问百度测试，响应时间
