搜狗浏览器只支持http和https协议，不支持socks协议，那么搜狗浏览器如何使用代理IP呢？ 本文将针对此问题进行详细说明。 在【代理ip】-【按时业务/按量业务】里查看自己购买的代理ip，然后点击【查看详情】查看自己的AuthKey跟AuthPwd；   使用自己购买的AuthKey去【调试工具】里面选择【提取IP资源】获取ip；   获取到ip之后，先打开搜狗浏览器，然后点击右上角的菜单；  点击【代理服务器】，然后选择【代理服务器设置】；  在弹出【自定义代理】，点击【添加】；  然后输入【代理名称】，【代理地址】跟【端口】然后勾选【需要验证】，然后输入【用户名】和【密码】（用户名就是AuthKey，密码就是AuthPwd），然后勾选【添加后立即启用】再点击【确定】；  浏览器打开https://myipip.net， 查询IP，结果里出现的IP地址和设置的代理IP一致，说明代理设置成功；  取消代理的话，先点击右上角菜单，点击【代理设置】，然后选择【不使用任何代理】即可取消掉代理。
**简要描述：** - 业务升级询价 **输入参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |suid |是 |string |业务标识 | |number |否 |integer | 升级后通道数，IP类型为静态、动态和隧道固定时长时必传；IP类型为隧道每次请求换ip时不需要传 | |connect |否 |integer | 升级后连接数，IP类型为隧道每次请求换ip时必传；其他类型不需要传 | **输入示例：** - https://qg.net/api/Proxyip/getUpgradePrice?suid=xxx&number=1 **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 0, "Data": { "OriginalPrice": "160", "TotalPrice": "120", }, "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |OriginalPrice |float |原价 | |TotalPrice |float |应付价格 | **备注：** 更多返回错误代码请看首页的错误代码描述。
**简要描述：** 获取按时业务详细信息。 **参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |suid |是 |string |业务标识 | **输入示例：** - https://qg.net/api/proxyip/view?suid=ebt2c7qr **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "Authkey": "2BE0556E", "Number": 3, "Buy_time": "2021-03-25 14:46:50", "End_time": "2022-03-28 14:46:50", "Order_status": 1, "Type": 1, "Ip_type": 2, "Tunnel_url": "tunnel.qg.net:3434" }， "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Authkey |string |Authkey | |Number |integer |通道数| |Connect |integer |连接数| |Buy_time |string |购买时间| |End_time |string |到期时间| |Order_status |string |状态 1：正常, 3：过期,-4：开通失败; -5：续费失败, -6：升级失败, -7：锁定| |Type |integer |资源类型 1：独享,2：共享；3：独占| |Ip_type |integer |IP类型 1：静态,2：动态，3：隧道| |Tunnel_url |string |隧道地址| **备注：** 更多返回错误代码请看首页的错误代码描述。
**简要描述：** 获取按量业务详细信息。 **参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |resource_no |是 |string |按量业务标识 | **输入示例：** - https://qg.net/api/proxyip/resourceView?resource_no=xxx **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "Authkey": "3BZEOGS0", "Number": 10000, "Buy_time": "2021-03-25 16:15:21", "End_time": "2023-03-25 16:15:21", "Order_status": 1, "Type": 2, "Ip_type": 2, "Resource_available": 10000, "Tunnel_url": "tunnel.qg.net:3434" }， "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Authkey |string |Authkey | |Number |integer |按量业务总量| |Connect |integer |连接数| |Buy_time |string |生效时间| |End_time |string |失效时间| |Order_status |string |状态 1：正常, 3：过期,-1：已失效,-4：开通失败;-5：续费失败, -6：升级失败, -7：锁定| |Type |integer |资源类型 1：独享，2：共享；3：独占| |Ip_type |integer |IP类型 1：静态，2：动态，3：隧道| |Resource_available |integer |按量业务余量| |Tunnel_url |string |隧道地址| **备注：** 更多返回错误代码请看首页的错误代码描述。
**简要描述：** 按量产品购买。 **输入参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |spec_id |是 |integer| 按量产品ID | |resource_number |是 |integer | 购买数量 | |Authkey |否 |string |Authkey | **输入示例：** - https://qg.net/api/Proxyip/resourcePay?spec_id=888&resource_number=1 **返回示例** JSON格式 ``` { "RequestId": "28A6D3E5-2369-B23C-8020-C2DC58AB7474" "Code": 200, "Message": "购买成功", "Data": { "Resource_no": "FYdqRLDsS", "Authkey": "ZYJLHVK1", "Authpwd": "0DBF3A35A953", "Tunnel_url" : "tunnel.qg.net:3434" }, } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Resource_no |string |按量业务标识 | |Authkey |string |Authkey | |Authpwd |string |Authpwd | |Tunnel_url |string |隧道地址 | **备注：** 更多返回错误代码请看首页的错误代码描述。
ECS之类的按时计费产品购买后5天内可无理由退款，按量付费类产品不支持退款
青果为有经验的开发者提供多种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_257_271_272/2141.html)** **[独享代理（地区锁）API接口文档 ＞ ](https://www.qg.net/doc/product/6_257_271_273/2142.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会失效。
## 1 接口描述 接口地址： https://proxy.qg.net/monopolies/ips ； 本接口是用于请求重拨独占资源； 请求频率限制：按时业务是（通道数*5＋10）次/分钟； 方法：PUT； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 | 参数名 | 是否必选 | 类型 | 描述 | | :----- | :------- | :----- | :----------------------------: | | Key | 是 | String | 重拨独占资源的Key值； | | UUIDs | 是 | String | 独占资源编号，多个用","隔开 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： | 返回字段 | 类型 | 描述 | | :------- | :----- | :--------------------------: | | data | Array | 重拨成功的独占资源编号数组 | | error | String | 错误信息 | ## 4 示例 请求接口示例： ``` curl -X PUT -d "Key=请改成您的Key&UUIDs=XXX,XXX" "https://proxy.qg.net/monopolies/ips" ``` 返回示例： ``` { "data": ["fj_qzdx1-2:ppp1"] //重拨成功的资源uuids } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | :----: | :------------------------------: | | 200 | 重拨成功 | | 400 | 重拨时间间隔限制或资源还在分配中 |
**简要描述：**
- 业务续费
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|suid |是 |string |业务标识|
|duration |是 |string |续费时长 单位：
- d: 天 例：1d（1天）
- w: 周 例：1w（1周）
- m: 月 例：1m（1个月）
|
**输入示例：**
- https://qg.net/api/Proxyip/renewOrderPay?suid=xxx&duration=1d
**返回示例**
JSON格式
```
{
"RequestId":'423369C7-AD6F-3GT6-NMJ7-E2RG5N6HG7D3',
"Code": 200,
"Message": "订单支付成功!",
"Data": {
"EndTime": "2022-03-29 14:35:54"
},
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|EndTime |date |业务到期时间 |
**备注：**
更多返回错误代码请看首页的错误代码描述。
## 功能说明 如果接口返回结果中存在 error 字段，则表示调用 API 接口失败。例如： ```json { "code": "NO_RESOURCE_FOUND", "message": "资源不足", "request_id": "83158ebe-be6c-40f7-a158-688741083edc" } ``` ## 错误码列表 | 错误码 | 描述 | | ---------------------------- | -------------------------------------------------------- | | INTERNAL_ERROR | 系统内部异常。 | | INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 | | INVALID_KEY | Key不存在或已过期。 | | UNAVAILABLE_KEY | Key不可用，已过期或被封禁 | | ACCESS_DENY | Key没有此接口的权限。 | | API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 | | BALANCE_INSUFFICIENT | Key余额不足。 | | NO_AVAILABLE_CHANNEL | 没有可用的空闲通道。 | | NO_RESOURCE_FOUND | 资源不足。 | | FAILED_OPERATION | 提取失败。 | | EXTRACT_LIMIT_EXCEEDED | 超出提取配额。 | | DELETE_LIMIT_EXCEEDED | 释放频率超出限制。 | | IP_WHITELIST_LIMIT_EXCEEDED | 白名单数量超出限制。 | | STATIC_DELETE_TIME_LIMIT | 静态资源需要24小时后才能释放。 | | MONOPOLY_DELETE_TIME_LIMIT | 独占资源需要12小时后才能释放。 | | MONOPOLY_CHANGEIP_TIME_LIMIT | 独占资源切换IP需要等待10秒。 |
