Sstap是一款代理客户端软件。本文将针对代理客户端SSTap使用教程进行详细的说明，具体步骤如下： 软件下载地址：https://github.com/solikethis/SSTap-backup ，下载后解压文件；  第一次打开软件，提示如图信息，点击【安装】；  点击【添加HTTP/SOCK4/SOCK5代理】；  设置代理类型，输入连接信息，点击【保存】即可；  点击【模式】，选择所需的模式，示例中选择【仅网页浏览器（全局）】，然后点击【连接】；  连接成功后提示--已连接！ 
本文将针对Windows10系统如何使用代理IP进行详细说明，具体步骤如下： 进入设置，点击【网络和Internet】;  找到左边的【代理】，将【手动设置代理】打开，地址填入申请到的代理IP，端口填写申请到的代理IP的端口，点击【保存】即可;  打开浏览器，会自动弹出需要输入用户名和密码的窗口，用户名即填写AuthKey，密码填写AuthPwd;  用浏览器搜索一下自己的IP测试一下是否代理成功。 
## 1 接口描述 接口地址：https://proxy.qg.net/release ； 本接口用于释放申请到的IP，以便于再次进行IP申请； 该接口接口频率限制是（通道数*5）次/分钟，单个Key的请求资源释放数量限制为：（通道数*2）次/分钟； 方法：HTTP、GET，需要注意不能混合使用； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Key |是 |String |释放的Key值 |TaskID |否 |String|任务ID；多个用","分割;\*代表全部| |IP |否 |Integer|节点IP；多个用","分割;*代表全部| PS: TaskID和IP二者选一必填 ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： |参数名|类型|描述| |:---- |:----- |----- | |Code |Integer |结果编码，0：成功；-1：失败| ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/release?Key=请改成您的Key&IP=*" ``` 返回示例： ``` { "Code": 0 } ``` ## 5 错误码 | 错误码 | 描述 | | ------------ | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | Authkey被封禁 | | -100 | 计划不存在或已过期 | | -105 | 释放的IP数超过允许释放的IP数 | | -106 | 静态IP需要24小时后才能释放 |
本文将针对安卓手机如何使用代理IP进行详细的说明，详细步骤如下：
1.购买代理IP后可以得到代理IP的账号和密码，在会员中心可查看详细的业务信息；
2.通过【调试工具】，输入AuthKey可以申请到代理IP；
3.在安卓手机中，找到【WIFI选项】，长按WIFI，点击修改【网络】；
4.将代理选项修改为手动，输入申请到的代理IP和端口号，点击【保存】即可；
5.打开浏览器，输入网址，会弹出输入用户名和密码，用户名和密码即为AuthKey和AuthPwd；
6.输入完毕后，可百度搜IP，即可查看本机IP是否代理IP。
## 1 请求结构 服务地址：目前支持的域名列表为: |接口域名|域名| |:---- |:---| |请求域名 |proxy.qg.net| ## 2 公共参数 公共参数是用于标识用户和接口的参数，如非必要，在每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Method |是 |String|具体操作的指令接口名称，例如想要调用查询代理IP列表接口，则Method参数即为query。 |Key |是 |String |在 https://www.qg.net 上购买代理IP后得到的标识身份的密钥Key。 |Num |否 |Integer|数量 |KeepAlive |否 |Integer|生存周期(单位分钟) | |AreaId |否 | Integer|区域编号(参考区域编号数据表) | |detail |否 |Integer|是否查看详情(可查看到具体的省市县信息) | |IP |否 | String| 节点IP，多个用"，"分割；全部以"* "表示 |Isp |否 | String| 运营商，默认随机，1:电信；2:移动；3:联通；4:BGP |TaskID |否 |String|任务ID，多个用"，"分割；全部以"* "表示 假设用户想要查询已申请的代理IP列表(其中Method为query)，则其请求链接的形式可能如下: https://proxy.qg.net/query?Key=密钥 ## 3 接口请求频率 接口频率限制时间均为一分钟内，从触发某个接口的时间开始计时的一分钟。具体详情如下： | 接口类型 | 频率限制 | | :------------ | :------------ | | /allocate 提取IP资源 | 按时：通道数*5+10，按量：60 | | /replace 更换IP资源 | 按时：通道数*5+10 | | /extract 获取IP资源池 | 动态共享按时：45 | | /release 释放IP资源 | 动态独享按时：通道数*5 | | /query 查询IP资源 | 按时：通道数*5+10 | | /whitelist/add 添加白名单 | 20 | | /whitelist/del 删除白名单 | 20 | | /whitelist/query 查询白名单 | 60 | | /info/quota 通道配额| 60 | | /resources 区域查询 | 60 | ## 4 释放次数限制 | 套餐类型 | 释放次数限制说明 | | ------------ | ------------ | | 动态独享 | 每分钟的释放限制次数为通道数*2 | | 动态共享 | 不能自主释放，套餐时长到期后自动释放 | | 静态独享 | 超过一天后能释放，一周不超过2次 | | 动态独占 | 添加的资源要12小时后才能更换 | ## 5 通信协议 青果云代理IP-API的所有接口均支持HTTP、HTTPS进行通信，提供高安全性的通信通道。 ## 6 请求方法 同时支持 POST 和 GET 请求，需要注意不能混合使用。即如果使用 GET 方式，则参数均从 Querystring 取得；如果使用 POST 方式，则参数均从 Request Body 中取得，Querystring 中的参数将忽略。两种方式参数格式规则相同，一般使用GET，当参数字符串过长时使用POST，请见各接口详细描述。 ## 7 字符编码 均使用UTF-8编码。
## 1. 接口描述
接口请求域名： static.proxy.qg.net。
本接口 (/get) 用于静态代理产品提取IP资源的接口。
默认接口请求频率限制：（通道数*5+10）次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------- | ------------------------------------------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| area | 否 | String | 按地区提取。 |
| isp | 否 | Integer | 按运营商提取。
0: 不筛选
1: 电信
2: 移动
3: 联通 |
| num | 否 | Integer | 提取个数，默认为1。 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ------------ | ----------------------------------------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data.task_id | String | 提取批次的ID。 |
| data.ips | Array of [IP](https://www.qg.net/doc/1839.html) | IP资源列表。 |
| data.num | Integer | 提取到的IP资源数量。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://static.proxy.qg.net/get?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": {
"task_id": "0LIKQ3S1_task",
"ips": [
{
"proxy_ip": "123.54.55.24",
"server": "123.54.55.24:59419",
"area": "河南省商丘市",
"isp": "电信",
"deadline": "2023-02-25 15:38:36"
}
],
"num": 1
},
"request_id": "83158ebe-be6c-40f7-a158-688741083edc"
}
```
## 5. 错误码
| 错误码 | 描述 |
| ---------------------- | ------------------------------------------------------------ |
| INTERNAL_ERROR | 系统内部异常。 |
| INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 |
| INVALID_KEY | Key不存在或已过期。 |
| UNAVAILABLE_KEY | Key不可用，已过期或被封禁 |
| ACCESS_DENY | Key没有此接口的权限。 |
| API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyIpManage)。 |
| KEY_BLOCK | Key被封禁。 |
| REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
| NO_RESOURCE_FOUND | 资源不足。 |
| FAILED_OPERATION | 提取失败。 |
## 1 接口描述 接口地址： https://proxy.qg.net/info/quota 本接口用于查询IP提取余量。 该接口单个Key的请求频率限制为：60次/分钟； 方法：HTTP、GET，需要注意不能混合使用； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Key |是 |String |查询的Key值 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： |参数名|类型|描述| |:---- |:----- |----- | |Code |Integer |结果编码| |Total |Integer |总数量| |Available|Integer |可用数量| |Used |Integer |已使用数量| ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/info/quota?Key=请改成您的Key" ``` 返回示例： ``` { "Code": 0, "Total": 5, "Available": 3, "Used": 2 } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | ------------ | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | AuthKey被封禁 | | -100 | 计划不存在或已过期 |
360浏览器如何使用代理IP呢？本文将针对此问题进行详细说明。 在【代理ip】-【按时业务】查看自己购买的代理ip，然后点击【查看详情】查看自己的AuthKey跟AuthPwd;   使用自己购买的AuthKey去【调试工具】里面选择【提取IP资源】获取ip;   获取到ip之后，先打开360浏览器，然后点击右上角的菜单;  点击【工具】，点击【代理服务器】，然后选择【代理服务器设置】;  在添加代理的窗口里面添加刚刚获取的代理ip跟端口。 ** 说明：** socks代理格式示例：118.121.199.170:30668@socks(socks代理设置不支持使用用户名密码，必须预先设置白名单后才能使用）。
<p><span style="font-size: 10.5pt; font-family: '微软雅黑','sans-serif';">目前支持直购、代付、返款3种模式，都是在官方价格上享受8.5折优惠.</span></p>
## 1 接口描述 接口地址：https://proxy.qg.net/query ； 本接口用于查询用户可用的代理IP资源列表； 该接口单个Key的请求频率限制为：（通道数*5+10）次/分钟； 方法：HTTP、GET，需要注意不能混合使用； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Key |是 |String |查询的Key值 | |TaskID |否 |String|任务ID；多个用","分割；默认全部 | |Detail |否 |Integer|详情，0：关闭；1：开启；默认为0 | ## 3 返回值 接口可返回json格式，字段说明如下： |参数名|类型|描述| |:---- |:----- |----- | |Code |Integer |结果编码，0：成功；-1：失败| |TotalNum |Integer |总IP数| |TaskNum |Integer |任务数| |TaskList |Array |任务列表| ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/query?Key=请改成您的Key" ``` 返回示例： ``` { "Code": 0, "TaskList": [ { "TaskID": "91107E16D28AC5A", "Num": 1, "Data": [ { "IP": "127.0.0.1", "port": "21504", "deadline": "2022-11-18 15:06:05", "host": "114.231.8.147:21504" } ] } ], "TaskNum": 1, "TotalNum": 1 } ``` **重点：在共享企业池的产品中使用该接口，查询出来的IP资源Data结构中的host和IP是不一样的，其他产品下host和IP是一样的。企业池产品中用户使用host进行代理，这时真实的代理IP为IP字段的IP（运营商为移动的情况下可能不会那么准确，即使代理IP可能不通，也都是同一个地区的IP，影响不会大）** ## 5 接口返回错误码 | 错误码 | 描述 | | ------------ | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | Authkey被封禁 | | -100 | 计划不存在或已过期 |
