短效代理（全球HTTP）开发者指南-代码示例-青果网络

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

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

## 步骤总览

![api2](https://article.qg.net/Uploads%2Fimage%2F2024-12-16%2F153708e85f5ad.png)

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

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

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

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

![image-20241225175234883](https://article.qg.net/Uploads%2Fimage%2F2024-12-25%2F175235509ac6b.png)

![image-20241225175606761](https://article.qg.net/Uploads%2Fimage%2F2024-12-25%2F1756067c4d2a7.png)

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

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

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

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

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

![image-20241225175518259](https://article.qg.net/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://article.qg.net/Uploads%2Fimage%2F2024-04-25%2F151330048e875.png)

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

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

![image-20240425151955693](https://article.qg.net/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)**

## 三、代理测试

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

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

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

![image-20240426180650605](https://article.qg.net/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会失效。

## 其他应用

### 隧道池支持通过账密指定参数

####参数规则

| 参数   | 含义                 | 格式            |示例
| ---------- | --------------------------- | ---------------------- |----------------------- |
| -A-   | 指定地区（单个）  |-A-{国家编码} 或 -A-{国家英文缩写}  |-A-990100 / -A-US  |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |

* -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。同时支持国家编码和英文国家/地区缩写（如 US、JP、KR、GB 等）。
兼容旧格式 :A、:T（如 :A990100、:T60），旧格式仅支持拼在密码后面。

####参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
```
示例：
```curl
// 参数全部拼在 Authkey 后面
curl -x authkey-A-US-T-60:password@overseas-hk.tunnel.qg.net:12195 ip.sb

// 参数全部拼在 AuthPwd 后面
curl -x authkey:password-T-60-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb

// 参数分散在两边
curl -x authkey-T-60:password-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
```
优先级： 当两侧同时指定了相同参数时，密码侧优先。

####指定使用某个国家的IP

隧道池业务达到存活时长后会更换IP，通过 -A- 可将随机范围限定到某个地区。
使用英文缩写
```curl
curl -x authkey-A-US:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
```
使用国家编码
```curl
curl -x authkey-A-990100:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-990100@overseas-hk.tunnel.qg.net:12195 ip.sb
```
编码详见 [海外区域编码表](https://www.qg.net/doc/2282.html)，英文缩写采用 ISO 标准国家/地区代码。

####保持IP不变
如果需要多个请求维持同一个IP，可通过 -T- 指定存活时长（单位：秒）。
隧道池无需传通道，直接传 -T- 即可保持IP。 若指定的存活时长超出套餐限制，系统会自动按套餐允许的最大时长处理，不会超出。
```curl
// 参数在用户名侧
curl -x authkey-T-30:password@overseas-hk.tunnel.qg.net:12195 ip.sb

// 参数在密码侧
curl -x authkey:password-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
```

####组合使用
多个参数可以自由组合，顺序不限。
```curl
// 英文缩写指定美国 + 存活时长
curl -x authkey:password-A-US-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb

// 编码方式指定美国 + 存活时长
curl -x authkey:password-A-990100-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb

// 参数分布在两侧
curl -x authkey-A-JP:password-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
```