## 在哪里购买？我想先测试一下怎么办？ 我们为新用户提供6小时免费试用，马上联系客服开通试用。 另外，所有产品均提供包天（独享产品除外）套餐，用户可购买体验。[ 进入购买页面 ＞](https://www.qg.net/business/proxyip.html) ## 可以提供发票吗？ - 可以的，购买后可直接在会员中心--财务管理--发票管理去[申请发票 ＞](https://www.qg.net/user/bill/apply)。 - 普票提供电子发票，您可自己在开票记录中下载； - 专票提供纸质发票，我们会在5个工作日内开具发票并寄送到贵公司。 ## 我无法用支付宝或微信在线支付怎么办？ 您还可以线下汇款，支持银行卡转账，在会员中心--财务管理--充值管理中查看线下转账信息和转账流程。  ## 购买后可以退款吗？ 除了日付周付业务订单，满足退款条件是可以申请退款的。 对于满足条件的新购测试订单用户可享受无理由退款政策，其他情况享受常规退款政策。 ## 无理由退款政策 - 满足退款条件的订单7天无理由退款; ## 常规退款政策 - 订单7天内可申请按剩余使用时长退款，超过时间不支持退款; - 退款金额 = 订单金额 - 已使用时长扣除金额。 ## 购买后能更换产品吗？ 订单支付成功后是无法更换产品的； 如果您在使用中发现已购买的产品不适合，请申请退款后重新购买其它产品。
## 1 接口描述 接口地址： https://proxy.qg.net/monopolies 本接口是用于请求申请独占代理IP资源。 方法：POST； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 | 参数名 | 是否必选 | 类型 | 描述 | | :------- | :------- | :------ | :-------------------: | | Key | 是 | String | 申请独占资源的Key值 | | AreaCode | 否 | Integer | 地区编码，默认随机 | | Operator | 否 | Integer | 运营商，默认随机 | | Num | 否 | Integer | 数量，默认为1 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： | 返回字段 | 类型 | 描述 | | :------- | :----- | :------------: | | data | Array | 独占资源列表 | | error | String | 错误信息 | ## 4 示例 请求接口示例： ``` curl -X POST -d 'Key=请改成您的Key&AreaCode=XX&Operator=XXX&Num=1' 'https://proxy.qg.net/monopolies' ``` 返回示例： ``` { "data": [{ "uuid": "fj_qzdx9-1:ppp10", "area": “福建省泉州市”, "operator": "电信", "state": "排队(123)", //分成在线、离线、重拨中、排队中(等待秒数X) "monopolize_time": "2022-02-17 14:01:05", //独占时间 },{ ... }] } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | :----: | :------------: | | 201 | 创建成功 | | 400 | 独占资源不足 | | 400 | 通道数不足 | | 500 | 下放白名单失败 |
本文将针对Windows7系统如何使用代理IP进行详细说明，具体步骤如下： 右击桌面右下角网络，选择【打开网络和共享中心】；  点击【Internet选项】；  点击【连接】，在点击【局域网设置】；  在代理服务器框内输入地址和端口，地址为申请到的代理IP地址，端口为申请到代理IP的端口，点击【确定】即可 ；  打开浏览器，自动弹出要输入用户名和密码的窗口，填入用户名（AuthKey）密码（AuthPwd）；  用浏览器搜索IP，测试是否代理成功。 
```go package main import ( "fmt" "io/ioutil" "net/http" "net/url" ) func main() { authKey := "请改成您的Key" password := "请改成您的AuthPwd" proxyServer := "您的代理IP:端口号" targetURL := "https://api.ipify.org" rawURL := fmt.Sprintf("http://%s:%s@%s", authKey, password, proxyServer) proxyUrl, err := url.Parse(rawURL) if err != nil { panic(err) } client := http.Client{ Transport: &http.Transport{ Proxy: http.ProxyURL(proxyUrl), }, } req, _ := http.NewRequest("GET", targetURL, nil) rsp, err := client.Do(req) if err != nil { fmt.Printf("request failed: %s\n", err) return } defer rsp.Body.Close() body, err := ioutil.ReadAll(rsp.Body) if err != nil { fmt.Println(err) } else { fmt.Println(string(body)) } } ```
## 1.添加Proxy SwitchyOmega插件 Firefox浏览器Proxy SwitchyOmega插件获取地址： https://addons.mozilla.org/zh-CN/firefox/addon/switchyomega/?utm_source=addons.mozilla.org&utm_medium=referral&utm_content=search 点击 【添加到Firefox】后浏览器会弹出插件添加确认提醒，确认添加后即可；  确认添加提示，选择【添加】；  添加成功后将会自动跳转到设置页面，点击【下一步】查看该插件的介绍说明信息；  ## 2.创建代理IP连接 点击左侧菜单项目中的【情景模式】分组下方的【新增情景模式】进行添加代理IP连接信息；  新建情景模式，设置情景模式名称，模式类型默认选择【代理服务器】，确认【创建】；  点击左侧菜单项目中的【情景模式】分组下方的【qg.net】进行代理设置；  ## 3.设置代理连接信息 选择代理IP的连接协议类型并填入相应的代理IP的服务器地址和端口信息；  网址协议(默认) 一行的信息中，代理协议选择 【HTTP】, 并输入【代理服务器地址】和【代理端口】信息，可点击最后的【锁图标】，可输入账号密码进行【账密验证】登录连接；  例如：  帐号密码登录设置：  设置完毕后点击左侧菜单进行应用选项；  ## 4.连接代理IP服务器 使用前：  使用后： 选中添加的【qg.net】代理IP连接，并测试连接成功。 
**简要描述：**
API支持基于URL发起HTTP/HTTPS GET请求。请求参数需要包含在URL中。本文列举了GET请求中的结构解释，并提供了服务器的服务接入地址
**通信方式：**
以下为Start一条未编码的URL请求示例：
https://www.qg.net/api/
**简要描述：** 按量产品购买询价。 **输入参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |spec_id |是 |integer |按量产品ID | |resource_number |否 |integer | 购买数量 | **输入示例：** - https://qg.net/api/Proxyip/getResourcePrice?spec_id=888&resource_number=1 **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "OriginPrice"：134， "TotalPrice":68 }， "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |OriginPrice |float |原价 | |TotalPrice |float |应付价格 | **备注：** 更多返回错误代码请看首页的错误代码描述。
第一步，进入调试工具后，选择接口方法为【查询IP资源】； 第二步，在Key的输入框输入已购买的代理IP业务AuthKey值（在业务列表中查看），点击测试按钮即可在右侧返回结果； 如下图所示：  其中，TaskID为申请时的任务ID，每次申请IP时生成的TaskID都是唯一的，该ID可用于IP释放操作； port为端口号需要在日常使用中加在IP后面，deadline为到期时间。
## nodejs http ```javascript const http = require("http"); const url = require("url"); const targetURL = url.parse("https://api.ipify.org"); const proxyIp = "您的代理IP"; const proxyPort = 端口号; const authKey = "请改成您的Key"; const password = "请改成您的AuthPwd"; const base64 = new Buffer.from(authKey + ":" + password).toString("base64"); const options = { host: proxyIp, port: proxyPort, path: targetURL, method: "GET", headers: { "Host": urlParsed.hostname, "Proxy-Authorization": "Basic " + base64 } }; http.request(options, function (resp) { console.log("response status code: " + resp.statusCode); resp.pipe(process.stdout); }).on("error", function (err) { console.log("request failed: " + err); }).end(); ``` ## nodejs request ```javascript const request = require("request"); const targetUrl = "https://api.ipify.org"; const proxyIp = "您的代理IP"; const proxyPort = 端口号; const authKey = "请改成您的Key"; const password = "请改成您的AuthPwd"; const proxyUrl = "http://" + authKey + ":" + password + "@" + proxyIp + ":" + proxyPort; const req = request.defaults({'proxy': proxyUrl}); const options = { url: targetUrl, headers: {} }; req.get(options, function (err, resp, body) { if (err) { return console.log(err); } console.log("response status code: " + resp.statusCode); console.log("response body: " + body); }).on("error", function (err) { console.log("request failed: " + err); }); ``` ## nodejs superagent ```javascript const request = require("superagent"); require("superagent-proxy")(request); const targetUrl = "https://api.ipify.org"; const proxyIp = "您的代理IP"; const proxyPort = 端口号; const authKey = "请改成您的Key"; const password = "请改成您的AuthPwd"; const proxyUrl = "http://" + authKey + ":" + password + "@" + proxyIp + ":" + proxyPort; request.get(targetUrl).proxy(proxyUrl).end(function onResponse(err, resp) { if (err) { return console.log(err); } console.log("response status code: " + resp.statusCode); console.log("response body: " + resp.text); }); ``` ## nodejs axios ```javascript const axios = require("axios") const {HttpsProxyAgent} = require("https-proxy-agent") const targetUrl = "https://api.ipify.org" const proxyIp = "您的代理IP" const proxyPort = 端口号 const authKey = "请改成您的Key" const password = "请改成您的AuthPwd" const proxy = new HttpsProxyAgent(`http://${authKey}:${password}@${proxyIp}:${proxyPort}`) axios.get(targetUrl, { httpAgent: proxy, httpsAgent: proxy, }).then(function (response) { console.log("response body: " + response.data) }).catch(function (error) { console.log("request failed: " + error) }).finally(function () { console.log("request finished.") }) // 如果目标站是HTTPS，则需要使用下面的代码进行代理请求 let httpsProxyAgent = require('https-proxy-agent'); var agent = new HttpsProxyAgent(`http://${authKey}:${password}@${proxyIp}:${proxyPort}`); var config = { url: "https://api.ipify.org", httpsAgent: agent } axios.request(config) .then(function(response) { console.log("response body: " + response.data) }).catch(function(error) { console.log("request failed: " + error) }) ```
青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 ## 步骤总览  ## 一、获取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)** ## 二、授权验证 正式使用代理之前，还需要通过授权验证。青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。  详细步骤可查看＞[代理验证](https://www.qg.net/doc/use/8_244/1574.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会失效。
