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