1. 接口描述接口请求域名： longterm.proxy.qg.net。 本接口 (/get) 用于长效代理产品提取IP资源的接口。 默认接口请求频率限制：（通道数*5+10）次/分钟。 推荐使用调试工具进行调试，调试工具。 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 IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 data.num Integer 提取到的IP资源数量。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https:/longterm.proxy.qg.net/get?key=& 输出示例{ "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鉴权配置。 KEY_BLOCK Key被封禁。 REQUEST_LIMIT_EXCEEDED 请求频率超出限制。 NO_RESOURCE_FOUND 资源不足。 FAILED_OPERATION 提取失败。

1. 接口描述接口请求域名： share.proxy.qg.net。 本接口 (/aggregate/get) 用于短效代理产品弹性提取模式下提取IP的接口。 默认接口请求频率限制：60次/分钟。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 String 按地区提取。支持多地区筛选，逗号隔开。比如：”350500,330700”。 area_ex 否 String 排除某些地区提取。支持多地区排除，用逗号隔开。比如：”440100,450000”。 isp 否 Integer 按运营商提取。0: 不筛选1: 电信2: 移动3: 联通 num 否 Integer 提取个数，默认为1 distinct 否 Bool 去重提取，默认为false。如果为true则不会提取到已经在使用的IP资源。 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data Array of IP IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://share.proxy.qg.net/aggregate/get?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" } 5. 错误码 错误码 描述 INTERNAL_ERROR 系统内部异常。 INVALID_PARAMETER 参数错误（包含参数格式、类型等错误）。 INVALID_KEY Key不存在或已过期。 UNAVAILABLE_KEY Key不可用，已过期或被封禁 ACCESS_DENY Key没有此接口的权限。 API_AUTH_DENY Api授权不通过，请检查Api鉴权配置。 KEY_BLOCK Key被封禁。 REQUEST_LIMIT_EXCEEDED 请求频率超出限制。 NO_RESOURCE_FOUND 资源不足。 FAILED_OPERATION 提取失败。 EXTRACT_LIMIT_EXCEEDED 超出提取配额。今天提取的IP数超出了购买的IP数，请明天再提取使用或者升级IP数。

1. 接口描述接口请求域名： exclusive.proxy.qg.net。 本接口 (/get) 用于独享代理产品提取IP资源的接口。 默认接口请求频率限制：（通道数*5+10）次/分钟。 推荐使用调试工具进行调试，调试工具。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 String 按地区提取。 isp 否 Integer 按运营商提取。0: 不筛选1: 电信2: 移动3: 联通 keep_alive 否 Integer 资源存活时长，单位分钟。 num 否 Integer 提取个数，默认为1。 distinct 否 Bool 去重提取，默认为false。如果为true则不会提取到已经在使用的IP资源。 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data.task_id String 提取批次的ID。 data.ips Array of IP IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 data.num Integer 提取到的IP资源数量。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://exclusive.proxy.qg.net/get?key=& 输出示例{ "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鉴权配置。 KEY_BLOCK Key被封禁。 REQUEST_LIMIT_EXCEEDED 请求频率超出限制。 NO_RESOURCE_FOUND 资源不足。 FAILED_OPERATION 提取失败。

1. 接口描述接口请求域名： overseas.proxy.qg.net。 本接口 (/get) 用于全球HTTP-短效代理产品通道提取模式下提取IP的接口。 默认接口请求频率限制：（通道数*5+10）次/分钟。 推荐使用调试工具进行调试，调试工具。 需注意，如使用白名单IP，请在提取前添加白名单。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 String 国家筛选。支持国家编码和自定义编码，比如：US,EU，或者990100,990200。国家编码 area_ex 否 String 排除某些地区提取。使用方式同上 num 否 Integer 提取个数，默认为1 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data Array of IP IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://overseas.proxy.qg.net/get?key=& 输出示例{ "code": "SUCCESS", "data": [{ "proxy_ip": "129.150.42.240", "server": "129.150.42.240:18080", "area": "新加坡", "deadline": "2023-02-25 15:38:36" }], "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鉴权配置。 KEY_BLOCK Key被封禁。 REQUEST_LIMIT_EXCEEDED 请求频率超出限制。 BALANCE_INSUFFICIENT Key余额不足。 NO_RESOURCE_FOUND 资源不足。 FAILED_OPERATION 提取失败。 EXTRACT_LIMIT_EXCEEDED 超出提取配额。

1. 接口描述接口请求域名： share.proxy.qg.net。 本接口 (/get) 用于短效代理产品弹性提取模式下提取IP的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，调试工具。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 String 按地区提取。支持多地区筛选，逗号隔开。比如：”350500,330700”。 area_ex 否 String 排除某些地区提取。支持多地区排除，用逗号隔开。比如：”440100,450000”。 isp 否 Integer 按运营商提取。0: 不筛选1: 电信2: 移动3: 联通 num 否 Integer 提取个数，默认为1 distinct 否 Bool 去重提取，默认为false。如果为true则不会提取到已经在使用的IP资源。 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data Array of IP IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://share.proxy.qg.net/get?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" } 5. 错误码 错误码 描述 INTERNAL_ERROR 系统内部异常。 INVALID_PARAMETER 参数错误（包含参数格式、类型等错误）。 INVALID_KEY Key不存在或已过期。 UNAVAILABLE_KEY Key不可用，已过期或被封禁 ACCESS_DENY Key没有此接口的权限。 API_AUTH_DENY Api授权不通过，请检查Api鉴权配置。 KEY_BLOCK Key被封禁。 REQUEST_LIMIT_EXCEEDED 请求频率超出限制。 NO_RESOURCE_FOUND 资源不足。 FAILED_OPERATION 提取失败。 EXTRACT_LIMIT_EXCEEDED 超出提取配额。今天提取的IP数超出了购买的IP数，请明天再提取使用或者升级IP数。

1. 接口描述接口请求域名： share.proxy.qg.net。 本接口 (/get) 用于短效代理产品均匀提取模式下提取IP的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，调试工具。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 String 按地区提取。支持多地区筛选，逗号隔开。比如：”350500,330700”。 area_ex 否 String 排除某些地区提取。支持多地区排除，用逗号隔开。比如：”440100,450000”。 isp 否 Integer 按运营商提取。0: 不筛选1: 电信2: 移动3: 联通 num 否 Integer 提取个数，默认为1 distinct 否 Bool 去重提取，默认为false。如果为true则不会提取到已经在使用的IP资源。 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data Array of IP IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://share.proxy.qg.net/get?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" } 5. 错误码 错误码 描述 INTERNAL_ERROR 系统内部异常。 INVALID_PARAMETER 参数错误（包含参数格式、类型等错误）。 INVALID_KEY Key不存在或已过期。 UNAVAILABLE_KEY Key不可用，已过期或被封禁 ACCESS_DENY Key没有此接口的权限。 API_AUTH_DENY Api授权不通过，请检查Api鉴权配置。 KEY_BLOCK Key被封禁。 REQUEST_LIMIT_EXCEEDED 请求频率超出限制。 NO_RESOURCE_FOUND 资源不足。 FAILED_OPERATION 提取失败。 EXTRACT_LIMIT_EXCEEDED 超出提取配额。 这分钟提取的IP数超出了购买数，请在下一分钟继续提取使用或者升级IP数

1. 接口描述接口请求域名： share.proxy.qg.net。 本接口 (/get) 用于短效代理产品通道提取模式下提取IP的接口。 默认接口请求频率限制：（通道数*5+10）次/分钟。 推荐使用调试工具进行调试，调试工具。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 String 按地区提取。支持多地区筛选，逗号隔开。比如：”350500,330700”。 area_ex 否 String 排除某些地区提取。支持多地区排除，用逗号隔开。比如：”440100,450000”。 isp 否 Integer 按运营商提取。0: 不筛选1: 电信2: 移动3: 联通 num 否 Integer 提取个数，默认为1。 distinct 否 Bool 去重提取，默认为false。如果为true则不会提取到已经在使用的IP资源。 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data Array of IP IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://share.proxy.qg.net/get?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" } 5. 错误码 错误码 描述 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 超出提取配额。

1. 接口描述接口请求域名： share.proxy.qg.net。本接口 (/get) 用于短效代理产品按量提取模式下提取IP的接口。默认接口请求频率限制：60次/分钟。推荐使用调试工具进行调试，调试工具。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 String 按地区提取。支持多地区筛选，逗号隔开。比如：”350500,330700”。 area_ex 否 String 排除某些地区提取。支持多地区排除，用逗号隔开。比如：”440100,450000”。 isp 否 Integer 按运营商提取。0: 不筛选1: 电信2: 移动3: 联通 num 否 Integer 提取个数，默认为1 distinct 否 Bool 去重提取，默认为false。如果为true则不会提取到已经在使用的IP资源。 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data Array of IP IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://share.proxy.qg.net/get?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" } 5. 错误码 错误码 描述 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 超出提取配额。

1. 接口描述接口请求域名： overseas.proxy.qg.net。 本接口 (/get) 用于全球HTTP-短效代理产品 按量提取模式下提取IP的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，调试工具。 需注意，如使用白名单IP，请在提取前添加白名单。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 String 国家筛选。支持国家编码和自定义编码，比如：US,EU，或者990100,990200。国家编码 area_ex 否 String 排除某些地区提取。使用方式同上 num 否 Integer 提取个数，默认为1 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data Array of IP IP资源列表。 注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://overseas.proxy.qg.net/get?key=& 输出示例{ "code": "SUCCESS", "data": [{ "proxy_ip": "129.150.42.240", "server": "129.150.42.240:18080", "area": "新加坡", "deadline": "2023-02-25 15:38:36" }], "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鉴权配置。 KEY_BLOCK Key被封禁。 REQUEST_LIMIT_EXCEEDED 请求频率超出限制。 BALANCE_INSUFFICIENT Key余额不足。 NO_RESOURCE_FOUND 资源不足。 FAILED_OPERATION 提取失败。 EXTRACT_LIMIT_EXCEEDED 超出提取配额。

1. 接口描述接口请求域名： monopoly.proxy.qg.net。 本接口 (/get) 用于独享代理产品启用地区锁功能后提取资源的接口。 默认接口请求频率限制：（通道数*5+10）次/分钟。 推荐使用调试工具进行调试，调试工具。 2. 输入参数 参数名称 必选 类型 描述 key 是 String 公共参数，产品唯一标识。 area 否 Integer 按地区提取。 isp 否 Integer 按运营商提取。 num 否 Integer 提取数量。默认：1 3. 输出参数 参数名称 类型 描述 code String 请求状态码。 data Array of Monopoly 独占资源列表。 request_id String 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 4. 示例输入示例GET https://monopoly.proxy.qg.net/get?key=& 输出示例{ "code": "SUCCESS", "data": [ { "uuid": "hn_sqdx2-1:ppp14", "area": "河南省商丘市", "isp": "电信", "state": "等待中(34)", "monopolize_time": "2023-02-25 09:45:10", }, { "uuid": "hn_sqdx2-1:ppp1", "area": "河南省商丘市", "isp": "电信", "state": "等待中(78)", "monopolize_time": "2023-02-25 09:45:10", } ], "request_id": "51024a8b-a8a5-4e78-9301-cb500a8c083e" } 5. 错误码 错误码 描述 INTERNAL_ERROR 系统内部异常。 INVALID_PARAMETER 参数错误（包含参数格式、类型等错误）。 INVALID_KEY Key不存在或已过期。 UNAVAILABLE_KEY Key不可用，已过期或被封禁 ACCESS_DENY Key没有此接口的权限。 API_AUTH_DENY Api授权不通过，请检查Api鉴权配置。 KEY_BLOCK Key被封禁。 REQUEST_LIMIT_EXCEEDED 请求频率超出限制。 NO_AVAILABLE_CHANNEL 没有可用的空闲通道。 NO_RESOURCE_FOUND 资源不足。 FAILED_OPERATION 提取失败。