分享页面
已经找到“” 的记录2541条
国内区域编码
|编号|区域| |:---- |:---|:----- |----- | |110000|北京市 |110100|市辖区 |120000|天津市 |120100|市辖区 |130000|河北省 |130100|石家庄市 |130200|唐山市 |130300|秦皇岛市 |130400|邯郸市 |130500|邢台市 |130600|保定市 |130700|张家口市 |130800|承德市 |130900|沧州市 |131000|廊坊市 |131100|衡水市 |140000|山西省 |140100|太原市 |140200|大同市 |140300|阳泉市 |140400|长治市 |140500|晋城市 |140600|朔州市 |140700|晋中市 |140800|运城市 |140900|忻州市 |141000|临汾市 |141100|吕梁市 |150000|内蒙古自治区 |150100|呼和浩特市 |150200|包头市 |150300|乌海市 |150400|赤峰市 |150500|通辽市 |150600|鄂尔多斯市 |150700|呼伦贝尔市 |150800|巴彦淖尔市 |150900|乌兰察布市 |152200|兴安盟 |152500|锡林郭勒盟 |152900|阿拉善盟 |210000|辽宁省 |210100|沈阳市 |210200|大连市 |210300|鞍山市 |210400|抚顺市 |210500|本溪市 |210600|丹东市 |210700|锦州市 |210800|营口市 |210900|阜新市 |211000|辽阳市 |211100|盘锦市 |211200|铁岭市 |211300|朝阳市 |211400|葫芦岛市 |220000|吉林省 |220100|长春市 |220200|吉林市 |220300|四平市 |220400|辽源市 |220500|通化市 |220600|白山市 |220700|松原市 |220800|白城市 |222400|延边朝鲜族自治州 |230000|黑龙江省 |230100|哈尔滨市 |230200|齐齐哈尔市 |230300|鸡西市 |230400|鹤岗市 |230500|双鸭山市 |230600|大庆市 |230700|伊春市 |230800|佳木斯市 |230900|七台河市 |231000|牡丹江市 |231100|黑河市 |231200|绥化市 |232700|大兴安岭地区 |310000|上海市 |310100|市辖区 |320000|江苏省 |320100|南京市 |320200|无锡市 |320300|徐州市 |320400|常州市 |320500|苏州市 |320600|南通市 |320700|连云港市 |320800|淮安市 |320900|盐城市 |321000|扬州市 |321100|镇江市 |321200|泰州市 |321300|宿迁市 |330000|浙江省 |330100|杭州市 |330200|宁波市 |330300|温州市 |330400|嘉兴市 |330500|湖州市 |330600|绍兴市 |330700|金华市 |330800|衢州市 |330900|舟山市 |331000|台州市 |331100|丽水市 |340000|安徽省 |340100|合肥市 |340200|芜湖市 |340300|蚌埠市 |340400|淮南市 |340500|马鞍山市 |340600|淮北市 |340700|铜陵市 |340800|安庆市 |341000|黄山市 |341100|滁州市 |341200|阜阳市 |341300|宿州市 |341500|六安市 |341600|亳州市 |341700|池州市 |341800|宣城市 |350000|福建省 |350100|福州市 |350200|厦门市 |350300|莆田市 |350400|三明市 |350500|泉州市 |350600|漳州市 |350700|南平市 |350800|龙岩市 |350900|宁德市 |360000|江西省 |360100|南昌市 |360200|景德镇市 |360300|萍乡市 |360400|九江市 |360500|新余市 |360600|鹰潭市 |360700|赣州市 |360800|吉安市 |360900|宜春市 |361000|抚州市 |361100|上饶市 |370000|山东省 |370100|济南市 |370200|青岛市 |370300|淄博市 |370400|枣庄市 |370500|东营市 |370600|烟台市 |370700|潍坊市 |370800|济宁市 |370900|泰安市 |371000|威海市 |371100|日照市 |371300|临沂市 |371400|德州市 |371500|聊城市 |371600|滨州市 |371700|菏泽市 |410000|河南省 |410100|郑州市 |410200|开封市 |410300|洛阳市 |410400|平顶山市 |410500|安阳市 |410600|鹤壁市 |410700|新乡市 |410800|焦作市 |410900|濮阳市 |411000|许昌市 |411100|漯河市 |411200|三门峡市 |411300|南阳市 |411400|商丘市 |411500|信阳市 |411600|周口市 |411700|驻马店市 |419000|省直辖县级行政区划 |420000|湖北省 |420100|武汉市 |420200|黄石市 |420300|十堰市 |420500|宜昌市 |420600|襄阳市 |420700|鄂州市 |420800|荆门市 |420900|孝感市 |421000|荆州市 |421100|黄冈市 |421200|咸宁市 |421300|随州市 |422800|恩施土家族苗族自治州 |429000|省直辖县级行政区划 |430000|湖南省 |430100|长沙市 |430200|株洲市 |430300|湘潭市 |430400|衡阳市 |430500|邵阳市 |430600|岳阳市 |430700|常德市 |430800|张家界市 |430900|益阳市 |431000|郴州市 |431100|永州市 |431200|怀化市 |431300|娄底市 |433100|湘西土家族苗族自治州 |440000|广东省 |440100|广州市 |440200|韶关市 |440300|深圳市 |440400|珠海市 |440500|汕头市 |440600|佛山市 |440700|江门市 |440800|湛江市 |440900|茂名市 |441200|肇庆市 |441300|惠州市 |441400|梅州市 |441500|汕尾市 |441600|河源市 |441700|阳江市 |441800|清远市 |441900|东莞市 |442000|中山市 |445100|潮州市 |445200|揭阳市 |445300|云浮市 |450000|广西壮族自治区 |450100|南宁市 |450200|柳州市 |450300|桂林市 |450400|梧州市 |450500|北海市 |450600|防城港市 |450700|钦州市 |450800|贵港市 |450900|玉林市 |451000|百色市 |451100|贺州市 |451200|河池市 |451300|来宾市 |451400|崇左市 |460000|海南省 |460100|海口市 |460200|三亚市 |460300|三沙市 |460400|儋州市 |469000|省直辖县级行政区划 |500000|重庆市 |500100|市辖区 |500200|县 |510000|四川省 |510100|成都市 |510300|自贡市 |510400|攀枝花市 |510500|泸州市 |510600|德阳市 |510700|绵阳市 |510800|广元市 |510900|遂宁市 |511000|内江市 |511100|乐山市 |511300|南充市 |511400|眉山市 |511500|宜宾市 |511600|广安市 |511700|达州市 |511800|雅安市 |511900|巴中市 |512000|资阳市 |513200|阿坝藏族羌族自治州 |513300|甘孜藏族自治州 |513400|凉山彝族自治州 |520000|贵州省 |520100|贵阳市 |520200|六盘水市 |520300|遵义市 |520400|安顺市 |520500|毕节市 |520600|铜仁市 |522300|黔西南布依族苗族自治州 |522600|黔东南苗族侗族自治州 |522700|黔南布依族苗族自治州 |530000|云南省 |530100|昆明市 |530300|曲靖市 |530400|玉溪市 |530500|保山市 |530600|昭通市 |530700|丽江市 |530800|普洱市 |530900|临沧市 |532300|楚雄彝族自治州 |532500|红河哈尼族彝族自治州 |532600|文山壮族苗族自治州 |532800|西双版纳傣族自治州 |532900|大理白族自治州 |533100|德宏傣族景颇族自治州 |533300|怒江傈僳族自治州 |533400|迪庆藏族自治州 |540000|西藏自治区 |540100|拉萨市 |540200|日喀则市 |540300|昌都市 |540400|林芝市 |540500|山南市 |540600|那曲市 |542500|阿里地区 |610000|陕西省 |610100|西安市 |610200|铜川市 |610300|宝鸡市 |610400|咸阳市 |610500|渭南市 |610600|延安市 |610700|汉中市 |610800|榆林市 |610900|安康市 |611000|商洛市 |620000|甘肃省 |620100|兰州市 |620200|嘉峪关市 |620300|金昌市 |620400|白银市 |620500|天水市 |620600|武威市 |620700|张掖市 |620800|平凉市 |620900|酒泉市 |621000|庆阳市 |621100|定西市 |621200|陇南市 |622900|临夏回族自治州 |623000|甘南藏族自治州 |630000|青海省 |630100|西宁市 |630200|海东市 |632200|海北藏族自治州 |632300|黄南藏族自治州 |632500|海南藏族自治州 |632600|果洛藏族自治州 |632700|玉树藏族自治州 |632800|海西蒙古族藏族自治州 |640000|宁夏回族自治区 |640100|银川市 |640200|石嘴山市 |640300|吴忠市 |640400|固原市 |640500|中卫市 |650000|新疆维吾尔自治区 |650100|乌鲁木齐市 |650200|克拉玛依市 |650400|吐鲁番市 |650500|哈密市 |652300|昌吉回族自治州 |652700|博尔塔拉蒙古自治州 |652800|巴音郭楞蒙古自治州 |652900|阿克苏地区 |653000|克孜勒苏柯尔克孜自治州 |653100|喀什地区 |653200|和田地区 |654000|伊犁哈萨克自治州 |654200|塔城地区 |654300|阿勒泰地区 |659000|自治区直辖县级行政区划
短效代理-均匀提取-查询资源地区接口
## 1. 接口描述 接口请求域名: share.proxy.qg.net。 本接口 (/resources) 用于短效代理产品均匀提取模式下查询资源地区的接口。 默认接口请求频率限制:60次/分钟。 推荐使用调试工具进行调试,[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------ | | key | 是 | String | 公共参数,产品唯一标识。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data | Array of [ResourceAreaISP](https://www.qg.net/doc/1839.html) | 资源地区列表。 | | request_id | String | 唯一请求ID,每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://share.proxy.qg.net/resources?key=<您的key信息> ``` #### 输出示例 ```json { "code": "SUCCESS", "data": [ { "area": "福建省泉州市", "area_code": 350500, "isp": "电信", "isp_code": 1, "available": false }, { "area": "河南省商丘市", "area_code": 411400, "isp": "电信", "isp_code": 1, "available": true } ],     "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鉴权配置](https://www.qg.net)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
计费模式
## 计费模式 代理IP产品主要计费方式为按时购买和按量购买,针对不同的代理IP产品,具有不同的计费方式,代理IP计费说明具体如下: ![image-20221118155652441](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-18/155653450ea26.png) ### 1.1 按时计费 按时付费是一种先付费后使用的计费方式。通过包年包月,您可以提前预留资源,同时购买的时长越长,享受更大的价格优惠; 1年以上时长的按时产品都有8.33折,帮您更大程度节省支出,如购买12个月,实际支付10个月的费用,购买36个月,实际支付30个月的费用。 所有的按时计费产品都支持免费试用6小时,通道数最大支持5,即同时可免费使用IP最大为5,方便业务测试,保证您能购买到满意的产品。 按时购买方式适用于每天持续运行的客户,更多业务场景需求可联系我们的客户经理咨询~ ### 1.2 按量计费 按量付费是一种先使用后付费的计费方式。通过按量付费,您可以按需购买IP数,IP提取未使用不计费,使用更灵活; 按量IP数的有效期统一为2年,有效期内IP数使用完,可通过【复购】生成同样资源配置的按量IP业务,便捷操作; 按量付费适合短时间需要大量优质IP的客户,也适合希望每天低成本使用少量IP的客户,使用灵活。 ## 续费与升级 ### 2.1 续费 ** 2.1.1 到期后业务状态变化** (1) 到期后,业务进入已过期状态,此时您可以续费业务,续费成功后保留所有代理资源和业务数据; (2) 包周到期后4小时之内,包年包月到期后5天之内,业务会从已过期状态进入业务保留回收中状态,此时您可以续费业务,如果续费失败,请稍后重试或联系客户经理解决;同时业务保留期间如果续费过期后未使用的天数也计算时间。 (3) 删除保留期到期后,未进行续费,所有代理资源和业务数据删除。 **2.1.2 续费** 续费功能仅适用于按时付费代理产品,按量付费代理产品不需要续费。 按时业务到期后会影响业务的正常运行。如果您想继续使用该代理业务,需要在指定时间内为业务续费,否则业务到期且数据保留到期后,业务会自动删除,将无法进行续费; 按时业务即将到期我们会进行提醒,需要续费的用户可及时续费,确保不影响业务的使用; 按量业务到期后或IP量使用完无法进行续费,需要买相同产品配置的代理按量产品直接【复购】即可,详情如下图: ![image-20221118155830487](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-18/15583289e4bcd.png) ### 2.2 升级 目前仅按时业务支持业务升级,主要是针对购买的通道数/请求数进行升级,升级价格计算公式:(升级配置价格[月] - 原始配置价格[月]) * 12 / 365 * 到期剩余天数,使用的过程中需要升级通道数/请求数,可至会员中心--代理IP--按时业务操作“升级”,具体位置如下图: ![image-20221115105744471](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-15/1057454c3a748.png)
购买指南
## 计费概述 青果代理IP产品购买方式:按时购买、按量购买,分别适用于不同场景下的用户需求。 ## 1 计费项及计费方式 ![image-20221118155540419](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-18/15554189b7eb5.png) *为保证获取到的价格的准确性,请您登录后查看。 ## 2 计费示例 产品:隧道代理(动态请求),10请求数/秒,时长6个月; 基础配置费用:360,隧道共享(动态请求),默认1个月,5请求/秒; 10请求数费用:(请求数-默认请求数)*请求数单价,60元/请求数,(10-5)×60=300; 总配置费用:基础价格*时长+请求数费用,360×6+300=3960元。 ## 3.续费说明 按时计费业务到期后将不可使用。如果您想继续使用代理IP资源,需要在指定时间内为业务续费,否则IP资源将不可用; 按量计费业务到期或用完之后无法续费,选择【复购】,会生成相同配置的业务; ## 4.支付与退款 购买代理IP产品,您可以选择以下支付方式: - 青果账户余额; - 在线支付,支持微信支付、支付宝,不能使用信用卡支付。
退款说明
## 退款概述 为了更加方便您使用青果代理IP,如果您在购买代理IP产品后有任何不满意,满足退款条件的业务我们支持申请退款。 根据不同计费方式特点,代理IP产品退款情况如下: ![image-20221118152550211](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-18/152552bca13bb.png) 满足退款条件的按时业务支持7天无理由申请退款,尽可能的确保您的产品使用体验感。 ## 退款流程 ### 2.1 业务详情--退款入口 满足退款条件的按时业务支持通过业务详情申请退订。进入会员中心,【代理IP】-【按时业务】,选择要退款的代理业务,操作列表中下拉【管理】按钮选择【查看详情】进入业务详情页,在业务的【付费信息】模块中可发起退款申请,详情如下图: ![image-20220928165745079](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-10-21/191127e958c34.png) ![image-20220928151814804](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-09-28/151816397aa1c.png) ### 2.2 订单退款 每个业务对应一个订单组,分别包括该业务下的新购订单、升级订单和续费订单等。 满足退款条件的新购订单发起退款申请,会一并对该订单开始时间之后的所有订单申请退款; ![image-20220928152029311](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-09-28/1520303005ff7.png) 新购订单后续进行了续费升级,可分别对续费订单进行退款申请,如下图: ![image-20221119142113616](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/142114f8a4c37.png) ### 2.3 退款管理 申请退款的业务在财务管理-退款管理中统一查看退款审批状态、退款金额等信息。 ![image-20221119142328750](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/142330078ab7d.png) ![image-20221119142415995](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/142417b190599.png) ## 退款流向 审核通过,退款成功后的资金流向,将退回青果账户余额。可在财务管理-交易明细中查看,如下图: ![image-20221119142448538](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/1424497a77801.png)
来自:常见问题
了解青果网络实名认证

为保护账号安全和享受更全面的青果网络服务,用户需要完成实名验证后才能购买/使用本司旗下产品,尚未完善信息的用户可以随着以下引导,对账户信息进行完善,进一步享受青果网络的优质服务。

1. 登录验证

打开青果网络官网登录后,进入控制台,在会员中心进入认证管理。

2. 认证管理

认证管理分为个人认证和企业认证两类,用户可根据需求进行身份验证。

2.1 个人验证

有支付宝认证和微信认证之分,选择其中一种方式认证即可。

如选择支付宝认证,填写完姓名和身份证号后打开支付宝扫描二维码:

根据提示进入人脸验证即可。

若选择微信认证,填写完姓名和身份证号后打开微信扫描二维码后进入微信人脸认证:

支付宝/微信人脸认证后,即可在青果网络完成个人实名认证。

2.2企业认证

企业认证有3种认证方式,按需任意选择其中一种认证。

2.2.1支付宝认证

用户需要按提示填写企业名称、统一社会信用代码、法人姓名、法人身份证号等相关真实信息。

企业支付宝扫码核验后完成实名认证。

注意:如果工商信息发生变更,需要上传的是变更后的最新营业执照。

2.2.2企业四要素认证

用户需要按提示填写企业名称、统一社会信用代码、法人姓名、法人身份证号、营业执照等相关真实信息后,弹出人脸验证二维码。

需要法人本人支付宝人脸验证或者微信人脸扫码验证,方可完成实名认证。

2.2.3 企业打款认证

相比支付宝认证和企业四要素认证,打款认证方式稍有不同,企业用户要先将:企业名称、统一社会信用代码、企业地址及营业执照填写上传,填写完成后,进入到打款测试页面。

企业用户此时用对公账户向青果网络转账0.01元,并在打款凭证内上传转账图片,提交完成。

待青果网络审核确认到账后,即可完成企业实名认证。

3.落实实名制服务管理

根据《网络安全法》相关要求,规定网络服务经营者、提供者及其他主体在与用户签订协议或者确认提供服务时应当采取实名认证制度。青果网络深入贯彻落实《网络安全法》,夯实新时期互联网安全工作,配合有关部门加强安全监管,保障数据安全,切实维护网络空间秩序,净化网络环境,共建和谐网络生态。

独享代理(地区锁)-API接口介绍
## 1 说明 通过编码使用独享代理(地区锁)主要有以下4步骤: 1.先在[提取工具](https://www.qg.net/tools/IPget.html)或[调试工具](https://www.qg.net/tools/IPdebug.html)上获取api接口; 2.使用白名单或账密进行授权验证; 3.进行代理测试;[查看测试步骤>>](https://www.qg.net/doc/1574.html "查看测试步骤") 4.参考[代码样例](https://www.qg.net/list/192.html)编写采集程序,使用代理IP。
## 2 API接口 独享代理(地区锁)API接口一览 | 接口类型 | API | 描述 | | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 资源相关 | - [get](https://www.qg.net/doc/product/6_257_271_273/1858.html)
- [query](https://www.qg.net/doc/product/6_257_271_273/1857.html)
- [delete](https://www.qg.net/doc/product/6_257_271_273/1856.html)
- [changeip](https://www.qg.net/doc/product/6_257_271_273/1855.html)
- [resources](https://www.qg.net/doc/product/6_257_271_273/1854.html)
| - 提取IP资源
- 查询在用IP资源
- 释放IP资源
- 更换IP资源
- 查询资源地区
| | 白名单相关 | - [whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "whitelist/del") | - 查询IP的白名单
- 添加IP的白名单
- 删除IP的白名单 |
独享代理-地区锁功能介绍
青果独享代理产品中,提供一种特殊的可指定所用IP是某个地区范围的功能,即为地区锁。 使用地区锁的用户可以锁定地区IP进行切换,不会因为资源紧张而出现提取不到指定地区IP的情况。适合于需要使用固定地区家庭IP的场景。 ## 地区锁使用方法 注意:启用地区锁后,提取速度会降低,使用方式也会改变。 #### 1. 查看地区锁启用状态: 在控制台中筛选“独享代理”产品,可通过地区锁字段查看当前业务是否启用地区锁功能![image-20230427115810055](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/14043884ecd2a.png) #### 2. 启用或者停用地区锁: 在业务列表中找到需要操作的业务,查看详情![image-20230427134032050](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/1404358b97dea.png)在详情页中,找到"地区锁"字段,进行启用或停用。切换地区锁功能,将强制释放已提取IP,并且12小时后才能切换地区锁。![image-20230427134229110](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/1404520feccac.png) #### 3. 在控制台中使用地区锁模式: 在业务列表找到已启用地区锁的业务,点击“地区锁”,进入管理页面。![image-20230427135104616](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/14045586d8ae5.png)在管理页面中,先根据购买的通道数资源,添加需要锁定的城市资源,然后在IP管理中进行切换或者移除即可。![image-20230427135310848](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/140457a61cd72.png) #### 4. 地区锁对应的API接口 当启用地区锁之后,所调用的API接口也会发生变化,[查看详情 >](https://www.qg.net/doc/2142.html)
独享代理-API接口介绍
## 1 说明 通过编码使用独享代理主要有以下4步骤: 1.先在[提取工具](https://www.qg.net/tools/IPget.html)或[调试工具](https://www.qg.net/tools/IPdebug.html)上获取api接口; 2.使用白名单或账密进行授权验证; 3.进行代理测试;[查看测试步骤>>](https://www.qg.net/doc/1574.html "查看测试步骤") 4.参考[代码样例](https://www.qg.net/list/192.html)编写采集程序,使用代理IP。
## 2 API接口 独享代理API接口一览 | 接口类型 | API | 描述 | | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 资源相关 | - [get](https://www.qg.net/doc/product/6_257_271_272/1840.html)
- [query](https://www.qg.net/doc/product/6_257_271_272/1841.html)
- [delete](https://www.qg.net/doc/product/6_257_271_272/1842.html)
- [replace](https://www.qg.net/doc/product/6_257_271_272/1843.html)
- [channels](https://www.qg.net/doc/product/6_257_271_272/1844.html)
- [resources](https://www.qg.net/doc/product/6_257_271_272/1845.html)
| - 提取IP资源
- 查询在用IP资源
- 释放IP资源
- 释放并重新提取IP资源
- 查询通道数
- 查询资源地区
| | 白名单相关 | - [whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "whitelist/del") | - 查询IP的白名单
- 添加IP的白名单
- 删除IP的白名单 | **重点:**独享代理只提供给单个客户使用,独享带宽和IP资源,IP可自主释放申请,因此新增接口更换IP资源/replace、释放IP资源/delete。 独享代理还有一种地区锁的模式,需要IP资源在固定地区的用户可以选择使用,相关API接口文档请[点击此处](https://www.qg.net/doc/product/6_257_271_273/2142.html)查看
代理IP调试工具
## 概述 购买完代理产品后,用户在使用代理IP的过程中,很多代理资源查询或代理使用,如替换、释放、通道配额等都需要在编程环境中才能调试运行获得,操作上存在局限性,调试工具则可以方便用户可以直接线上简单对接调试,便捷用户操作成本和缩减时间成本。 ## 工具说明 ### 2.1 请求方式 请求方式包括POST和GET,默认POST请求,根据自己的需求选择;右侧网址则是接口网址完整信息,包括选择的key、接口方法等参数信息。 ![image-20221021142244154](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-10-21/142245b7e321f.png) ### 2.2 key key为必选项,是对接接口的必要信息。key的选择根据登录状态不同,可操作性不同。未登录时,需手动输入key值,已登录时,可下拉选择已购买的代理业务key,key信息附带业务资源配置和业务备注信息,方便辨别业务。 未登录状态: ![image-20221021150143164](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-10-21/150144cfca96b.png) 已登录状态: ![image-20221021150245490](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-10-21/150247313c9a5.png) ### 2.3 接口方法 接口方法主要是选择要调试的接口类型,包括资源相关、IP白名单、信息查询三大模块,各个接口说明详情如下图: | 接口类型 | API | 描述 | | ------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | | 通用资源管理相关 | - [allocate](https://www.qg.net/doc/174.html "资源申请")
- [extract](https://www.qg.net/doc/1504.html "获取IP资源池")
- [replace](https://www.qg.net/doc/297.html "更换IP资源")
- [release](https://www.qg.net/doc/176.html "释放资源")
- [query](https://www.qg.net/doc/175.html "资源查询") | - 调用 allocate申请代理IP资源
- 调用extract获取IP资源池全部可用的IP信息
- 调用replace用于释放并申请新的代理IP,更换IP资源
- 调用release释放申请到的IP,以便于再次进行IP申请
- 调用query查询用户可用的代理IP资源列表 | | 独占代理专用相关 | - [monopolize_resources](https://www.qg.net/doc/1559.html )
- [monopolize_resources](https://www.qg.net/doc/1560.html)
- [monopolize_resources](https://www.qg.net/doc/1562.html)
- [monopolize_resources/newest_ips](https://www.qg.net/doc/1561.html )
-[monopolize_resources/idle](https://www.qg.net/doc/1563.html) | - 用POST调用接口申请独占资源
-用GET调用接口查询可用的独占资源
- 用DELETE调用接口释放独占资源
-用PUT调用接口请求重拨独占资源
-用GET调用接口查询空闲的独占资源 | | 白名单管理相关 | - [whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "删除白名单")
| - 调用 whitelist/query用于查询IP的白名单
- 调用whitelist/add用于添加IP的白名单
- 调用whitelist/del用于删除IP的白名单 | | 资源信息查询 | - [info/quota](https://www.qg.net/doc/181.html "info/quota")
- [resources](https://www.qg.net/doc/177.html "查询区域资源") | - 调用 info/quota查询IP提取余量
- 调用resources查询平台可用的代理IP资源列表 | ### 2.4 参数类型 调试工具中各个参数根据不同的接口类型对应显示,各个参数有不同的含义,详情如下: | 参数名 | 是否必选 | 描述 | | :------------ | :------- | ------------------------------------------------------------ | | Key | 是 | 要申请IP的业务的Key值,下拉选择即可; | | IP | 是 | 代理IP;多个以逗号分割;*代表全部; | | Num | 否 | 申请的IP个数,默认1个,最大不超过套餐内IP数量最大值; | | KeepAlive | 否 | IP生存周期,其中独享默认24小时,短效默认购买的套餐存活周期时长; | | AreaId | 否 | 区域ID;默认随机; | | ISP | 否 | 运营商ID;默认随机;1:电信,2:移动,3:联通,4:BGP | | Detail | 否 | 是否获取代理IP的详情,默认为 0关闭,1为开启; | | Distinct | 否 | 申请的IP是否去重,默认为0不去重,1为开启去重;短效代理、独享代理适用。 | | DataFormat | 否 | 数据格式,本接口取值:json、html、txt ,默认为 json格式 | | DataSeparator | 否 | 分隔符,自定义 | ### 2.5 结果参数说明 点击“测试”,右侧文本框区域显示接口请求结果,返回结果参数说明: | 参数名 | 描述 | | :-------- | -------------------------------------------------- | | Code | 申请IP结果编码:0(成功)-1(失败)。 | | TaskID | 接口请求任务ID,可通过该IP释放该任务所申请到的IP; | | Total | 获取到的代理IP总数量 | | Available | 获取到的代理IP可用数量 | | Used | 获取到代理IP已使用数量 | | Num | 申请的代理IP数量 | | TotalNum | 总IP数,主要是资源查询 | | Data | 代理IP数据信息,包含节点IP、端口、失效日期 | | Msg | 公共参数,本接口取值:区域ID. |

扫码添加专属客服

扫码关注公众号