**简要描述：**
- 业务购买
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|spec_id |是 |integer |按时产品ID |
|number |否 |integer | 通道数，IP类型为静态、动态和隧道固定时长时必传；IP类型为隧道每次请求换ip时不需要传 |
|connect |否 |integer | 连接数，IP类型为隧道每次请求换ip时必传；其他类型不需要传 |
|duration |是 |string | 购买时长 单位：
- s: 小时，免费使用时长 例：2s（2小时）
- d: 天 例：1d（1天）
- w: 周 例：1w（1周）
- m: 月 例：1m（1个月）
|
**输入示例：**
- https://qg.net/api/Proxyip/pay?spec_id=888&number=1&duration=1d
**返回示例**
JSON格式
```
{
"RequestId":'423369C7-AD6F-3GT6-NMJ7-E2RG5N6HG7D3',
"Code": 200,
"Message": "购买成功",
"Data": {
"AuthKey": "17710BD8",
"AuthPwd": "8560577FC33A",
"Suid": "hryp84er",
"Tunnel_url" : "tunnel.qg.net:3434"
},
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|AuthKey |string |AuthKey |
|AuthPwd |string |AuthPwd |
|Suid |string |业务标识 |
|Tunnel_url |string |隧道地址 |
**备注：**
更多返回错误代码请看首页的错误代码描述。
如何用Proxifier测试代理ip对指定网站的访问结果呢？本文给出详细说明。 1.打开软件，点击菜单栏【配置文件】中的【代理服务器】  2.在已经配置好代理ip的情况下，在弹出窗口中，点击【检查】；  3.在弹出窗口中，点击【测试设置】；  4.在弹出窗口中，勾选【测试2】栏目中的【启用该测试】并修改【目标主机】框内的地址后点击【确认】后保存；  5.回到上一个窗口后，点击【开始测试】，可以看到指定地址的访问结果； 
## 1 说明
通过编码使用短效代理（全球HTTP）-按量提取主要有以下4步骤：
1.先在[提取工具](https://www.qg.net/tools/IPget.html)或[调试工具](https://www.qg.net/tools/IPdebug.html)上获取api接口；
2.使用白名单或账密进行授权验证；
3.进行代理测试；[查看测试步骤＞＞](https://www.qg.net/doc/1574.html "查看测试步骤")
4.参考[代码样例](https://www.qg.net/list/192.html)编写采集程序，使用代理IP。
## 2 API接口
短效代理（全球HTTP）-按量提取API接口一览
| 接口类型 | API | 描述 |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [get](https://www.qg.net/doc/product/6_259_275_276/1865.html)
- [query](https://www.qg.net/doc/product/6_259_275_276/1864.html)
- [balance](https://www.qg.net/doc/product/6_259_275_276/1866.html)
- [resources](https://www.qg.net/doc/product/6_259_275_276/1867.html)
| - 提取IP资源
- 查询在用IP资源
- 查询余额
- 查询国家资源
|
| 白名单相关 | - [whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "删除白名单")
| - 查询IP的白名单
- 添加IP的白名单
- 删除IP的白名单 |
##1 接口描述 接口地址： https://proxy.qg.net/monopolies 本接口是用于释放申请到的独占IP，以便于再次进行独占IP申请。 请求限制：独占资源在申请后12小时才可释放，如果资源故障，可提交工单我们会强制释放； 方法：DELETE； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 | 参数名 | 是否必选 | 类型 | 描述 | | :----- | :------- | :----- | :----------------------------: | | Key | 是 | String | 释放独占资源的Key值； | | UUIDs | 是 | String | 独占资源编号，多个用","隔开。 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： | 返回字段 | 类型 | 描述 | | :------- | :----- | :--------------------------: | | data | Array | 释放成功的独占资源编号数组； | | error | String | 错误信息 | ## 4 示例 请求接口示例： ``` curl -X DELETE "https://proxy.qg.net/monopolies?Key=请改成您的Key&UUIDs=XX,XXXX" ``` 返回示例： ``` { "data": ["fj_xmdx2-1:ppp10"] //删除成功的资源 } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | :----: | :------------------------------: | | 200 | 删除成功 | | 400 | 释放时间限制，申请后12小时可释放 |
## 1 接口描述 接口地址： https://proxy.qg.net/monopolies/idle 本接口是用于查询空闲可申请的独占资源。 请求频率限制：60次/分钟； 方法：GET； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 | 参数名 | 是否必选 | 类型 | 描述 | | :----- | :------- | :----- | :-------------------: | | Key | 是 | String | 查询独占资源的Key值 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： | 返回字段 | 类型 | 描述 | | :------- | :----- | :------------: | | data | Array | 独占资源列表 | | error | String | 错误信息 | ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/monopolize_resources/idle?Key=请改成您的Key" ``` 返回示例： ``` { "data": [{ "area": "福建省泉州市", "area_code": 350500, "operator": "电信", "operator_code": 1, "idle": 30 },{ ... }] } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | :----: | :------: | | 200 | 查询成功 | | 500 | 未知错误 |
青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 ## 步骤总览  ## 一、API鉴权与代理授权 青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作 API鉴权指是指在访问API接口时对用户进行身份验证和权限检查，以确保API接口的安全性和可靠性。 用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权】中进行设置即可。  代理授权验证是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。 青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。 相关入口和信息在业务管理页面可看到。  详细步骤可查看＞[如何使用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接口。 点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。  调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。 若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门[＞＞提取工具 ](https://www.qg.net/tools/IPget.html)  ② 查看api接口文档 除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。 **[点击查看API接口文档 ＞](https://www.qg.net/doc/product/6_258_274/2143.html)** ## 三、代理测试 在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 `curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl}`  若响应不成功，可对应[错误码表](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会失效。
**简要描述：** - 获取按时产品列表信息。 **输入示例：** - https://qg.net/api/Proxyip/channelSpecList **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "1":{ "Id": 1, "Spec_name": "独享动态", "Spec_no": "14995", "Trial_time": 8, "Day_rate": "0.08", "Week_rate": "0.40", "Month_rate": "1,3,6,10,20,30", "Computing_time": "1,3,6,12,24,36", "Show_status": 1, "Buy_status": 1, "Renew_status": 1, "Upgrade_status": 1, "Content": "IP数量 : 同时可使用的IP数等于购买的通道数 IP存活时长 : 自由控制，最长24小时，IP存活时长大于30秒后，可以随时更换IP IP可用率 : ＞99.9%，IP检测可用后才会进入IP池 IP重复率 : <1%?优先分配未使用IP给客户 IP分布地区 : 全国主要省份?更多城市还在不断增加中 终端数限制 : 不限制?支持多机器或多进程同时使用代理IP 带宽峰值限制 : 10Mbps 地区筛选 : 支持指定获取某个城市IP或全国随机 代理类型 : HTTP、HTTPS、SOCKS5", "Basic_price": "59.00", "Group_type_id": 1, "Brand_name": "青果云", "Create_time": 1598204266, "Update_time": 1598204266, "Connect_limit": 132, "Connect_price": "10.00", "Connect_gift": 1, "Connect_list": "1-10", } }， "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Id |integer |ID | |Spec_name |string |产品名称 | |Trial_time |integer |试用时间 单位小时| |Day_rate |float |日付费率 | |Week_rate |float |周付费率 | |Month_rate |float |月付费率 | |Computing_time |string |可选时长 | |Show_status |integer |显示状态 1:显示 0：不显示 | |Buy_status |integer |购买状态 1:启用 0：禁用 | |Renew_status |integer |续费状态 1:启用 0：禁用 | |Upgrade_status |integer |升级状态 1:启用 0：禁用| |Content |string |基本介绍| |Basic_price |float |基础价格 | |Group_type_id |integer |规格ID| |Brand_name |string |品牌名称| |Connect_limit |string |IP类型为动态或者静态：连接数限制；IP类型为隧道固定时长：请求数限制| |Connect_price |string |连接数单价| |Connect_gift |string |连接数赠送值| |Connect_list |string |连接数可选值| **备注** - 更多返回错误代码请看首页的错误代码描述
**简要描述：** - 业务升级 **输入参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |suid |是 |string |业务标识 | |number |否 |integer | 升级后通道数，IP类型为静态、动态和隧道固定时长时必传；IP类型为隧道每次请求换ip时不需要传 | |connect |否 |integer | 升级后连接数，IP类型为隧道每次请求换ip时必传；其他类型不需要传 | **输入示例：** - https://qg.net/api/product/upgradeOrderPay?suid=xxx&number=xxx&公共部分 **返回示例** JSON格式 ``` { "RequestId":'423369C7-AD6F-3GT6-NMJ7-E2RG5N6HG7D3', "Code": 200, "Message": "订单支付成功!", "Data": { "Number": 3 }, } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Number |integer | 升级后通道数 | |Connect |integer | 升级后连接数 | **备注：** 更多返回错误代码请看首页的错误代码描述。
阿里云和我司客服人员均会在到期前15天内向您发送到期或余额不足的提醒，及时未能及时续费，我们也将为你保留7天不被释放，但未避免业务影响建议提前进行续费。
**简要描述：**
- 业务续费询价
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|suid |是 |string |业务标识 |
|duration |是 |string | 续费时长 单位：
- d: 天 例：1d（1天）
- w: 周 例：1w（1周）
- m: 月 例：1m（1个月）
|
**输入示例：**
- https://qg.net/api/Proxyip/getRenewPrice?suid=xxx&duration=1m
**返回示例**
JSON格式
```
{
"RequestId":"ASDF4ASF-ASDFASF",
"Code": 0,
"Data": {
"TotalPrice": "1231",
"OriginalPrice": "12154545",
"EndTime": "2020-05-20 00:00:00",
},
"Message":"获取成功",
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|TotalPrice |float |应付价格 |
|OriginalPrice |float |原价 |
|EndTime |date |业务到期时间 |
**备注：**
更多返回错误代码请看首页的错误代码描述
