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. 接口描述接口请求域名： 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 提取失败。

青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 步骤总览 一、API鉴权与代理授权青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作 API鉴权是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。 用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。 代理授权验证是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。 青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。 白名单设置的入口与API鉴权一样。 详细步骤可查看＞如何使用API鉴权、代理验证 二、获取api接口青果给开发者提供两种方式来获得api接口 ① 使用调试工具/提取工具 调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门＞＞调试工具 使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。 点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。 调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。 若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门＞＞提取工具 ② 查看api接口文档 除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。 点击了解API接口文档 ＞弹性提取类型、按量提取类型、均匀提取类型、通道提取类型 三、代理测试在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl} 若响应不成功，可对应错误码表，排查问题。 四、编写采集程序测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例供开发者参考， 详情查看 C语言代码示例Go语言代码示例PHP语言代码示例Python语言代码示例Java语言代码示例Shell语言代码示例C#语言代码示例Node语言代码示例 注：青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。