短效代理（全球HTTP）开发者指南-产品介绍-青果网络

**全球HTTP均不支持在中国大陆地区网络环境下使用。**
青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。

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

## 步骤总览

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

## 一、获取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_259_275_276/2144.html)、[通道提取类型](https://www.qg.net/doc/product/6_259_275_277/2262.html)**

## 二、授权验证

正式使用代理之前，还需要通过授权验证。青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。

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

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

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

详细步骤可查看＞[代理验证](https://www.qg.net/doc/use/8_244/1574.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)，排查问题。

## 四、编写采集程序

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

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

详情查看
- [SDK下载](https://www.qg.net/doc/sdk/9_230/1745.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会失效。