分享页面

独享代理开发者指南

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

青果为有经验的开发者提供多种API接口及代码示例,以协助开发者更便利地使用代理。

本篇仅以【提取IP】这一操作为例,介绍如何使用API接口-代码方式来使用代理。

步骤总览

api2

一、API鉴权与代理授权

青果支持开发者对API鉴权和代理授权验证进行自主管理,以下介绍这一阶段的操作

API鉴权是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性,用户可以根据需要选择启用或关闭该功能。

用户可根据意愿选择开启和关闭API鉴权(默认关闭),青果提供的鉴权方式有密码和白名单两种,在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。

image-20241225175234883

image-20241225175606761

代理授权验证是指对代理身份进行验证,只有通过对应信息才能使用该代理IP,确保您的使用权益和安全性。

青果代理IP支持白名单和帐密两种验证方式,可自主选择使用。

白名单模式,即把要实现代理的服务器IP添加进代理白名单中,后续使用该IP连接代理就能成功;

账密模式,即先获取该代理业务的账号密码信息,连接代理时填入账密进行验证就可使用代理。

白名单设置的入口与API鉴权一样。

image-20241225175518259

详细步骤可查看>如何使用API鉴权代理验证

二、获取api接口

青果给开发者提供两种方式来获得api接口

① 使用调试工具/提取工具

调试工具是青果为开发者推出的快速获取接口&调试的简便工具,传送门>>调试工具

使用调试工具,用户需要先在左侧栏目中选好产品及接口类型,并在右侧表格的参数值列中填写所需信息,便可在页面上方看到完整的【请求地址】,这便是提取IP的API接口。

点击【发送】还能快速调试,查看响应结果,确认该代理接口是否可用。

image-20240425151330263

调试工具除了有提取IP接口,还提供查询在用IP、资源池、资源地区等接口。

若只需要提取IP,也可以使用提取工具,进行简单的选择便可以获取一样的接口链接。传送门>>提取工具

image-20240425151955693

② 查看api接口文档

除了简便工具,开发者也可以通过更原始的接口文档,自主编写所需的接口链接。

独享代理API接口文档 >
独享代理(地区锁)API接口文档 >

三、代理测试

在代理服务器中打开命令行,输入相应的代理信息进行运行,若响应成功,则代理可用。

以下图为例,通过curl命令测试账密模式的代理结果,查询IP并成功响应。

curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl}

image-20240426180650605

若响应不成功,可对应错误码表,排查问题。

四、编写采集程序

测试代理可用后,便可开始编写代理采集程序了。

青果提供了多种编程语言的代码示例以及SDK下载包供开发者参考,

详情查看

注:青果代理IP产品都有相对应的IP存活周期,其有效时长是从提取到IP时算起,超过这个时长IP会失效。