短效代理开发者指南-文档中心-青果网络

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

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

## 步骤总览

![api2](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-12-16%2F153708e85f5ad.png)

## 一、API鉴权与代理授权

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

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

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

![image-20241225175234883](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-12-25%2F175235509ac6b.png)

![image-20241225175606761](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-12-25%2F1756067c4d2a7.png)

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

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

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

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

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

![image-20241225175518259](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-12-25%2F175518b9f31b2.png)

详细步骤可查看＞[如何使用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接口。

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

![image-20240425151330263](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-25%2F151330048e875.png)

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

若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门[＞＞提取工具 ](https://www.qg.net/tools/IPget.html)

![image-20240425151955693](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-25%2F1519556890211.png)

② 查看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}`

![image-20240426180650605](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-26%2F1806504f4e31e.png)

若响应不成功，可对应[错误码表](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会失效。

使用指南

短效代理开发者指南