接口請求域名: share.proxy.qg.net。
本接口 (/get) 用于短效代理產品通道提取模式下提取IP的接口。
默認接口請求頻率限制:(通道數*5+10)次/分鐘。
參數名稱 | 必選 | 類型 | 描述 |
---|---|---|---|
key | 是 | String | 公共參數,產品唯一標識。 |
area | 否 | String | 按地區提取。支持多地區篩選,逗號隔開。比如:”350500,330700”。 |
area_ex | 否 | String | 排除某些地區提取。支持多地區排除,用逗號隔開。比如:”440100,450000”。 |
isp | 否 | Integer | 按運營商提取。 0: 不篩選 1: 電信 2: 移動 3: 聯通 |
num | 否 | Integer | 提取個數,默認為1。 |
format | 否 | Integer | 數據格式。默認為TXT,分別值有JSON,HTML。 |
distinct | 否 | Bool | 去重提取,默認為false。如果為true則不會提取到已經在使用的IP資源。 |
參數名稱 | 類型 | 描述 |
---|---|---|
code | String | 請求狀態碼。 |
data | Array of iP | IP資源列表。 注:IP結構中的server才是代理地址,proxy_ip是代理的真實出口IP。 |
request_id | String | 唯一請求ID,每次請求都會返回。定位問題時需要提供該次請求的 request_id。 |
GET https://share.proxy.qg.net/get?key=<您的key信息>&<其他輸入參數>
{
"code": "SUCCESS",
"data": [
{
"proxy_ip": "123.54.55.24",
"server": "123.54.55.24:59419",
"area": "河南省商丘市",
"isp": "電信",
"deadline": "2023-02-25 15:38:36"
}
],
"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鑒權配置。 |
KEY_BLOCK | Key被封禁。 |
REQUEST_LIMIT_EXCEEDED | 請求頻率超出限制。 |
BALANCE_INSUFFICIENT | Key余額不足。 |
NO_RESOURCE_FOUND | 資源不足。 |
FAILED_OPERATION | 提取失敗。 |
EXTRACT_LIMIT_EXCEEDED | 超出提取配額。 |