跳转到主要内容
本文档主要介绍 ADSL Proxy API 操作的使用流程，利用它我们可以轻松提取 ADSL 的 IP 并且对 ADSL Proxy 添加 IP 白名单。

​
申请流程

要使用提取 ADSL 的 IP 和对 ADSL Proxy 添加 IP 白名单，首先可以到 ADSL Proxy Extract API 和 ADSL Proxy Whitelist API 页面点击「Acquire」按钮，获取请求所需要的凭证： 如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。 在首次申请时会有免费额度赠送，可以免费使用该 API。

​
提取 ADSL 的 IP

接下来就可以在界面 ADSL Proxy Extract API 上填写对应的内容，接下来演示如何提取 ADSL 的 IP。

​
设置请求头和请求体

Request Headers 包括：
  • accept：指定接收 JSON 格式的响应结果，这里填写为 application/json。
  • authorization：调用 API 的密钥，申请之后可以直接下拉选择。
Request Body 包括：
  • number：提取的 ADSL 的 IP 数量，默认为 1。
  • type：提取的 ADSL 的 IP 类型，主要分为 http 和 socks，默认为 http 。
  • province：提取 IP 的所在省份，默认是随机的。
  • city：提取 IP 的所在城市，默认是随机的。
对于参数 province 和 city 的设定，它是有要求的，它必须是对应的，比如city ：南昌必须对应 province ：江西，需要与省份对应起来，具体的规则如下： 
{"province":"北京","city":"北京","pId":0,"cId":0},{"province":"天津","city":"天津","pId":1,"cId":1},{"province":"上海","city":"上海","pId":2,"cId":3},{"province":"重庆","city":"重庆","pId":3,"cId":4},{"province":"黑龙江","city":"大兴安岭地区","pId":4,"cId":7},{"province":"黑龙江","city":"黑河","pId":4,"cId":8},{"province":"黑龙江","city":"齐齐哈尔","pId":4,"cId":9},{"province":"黑龙江","city":"绥化","pId":4,"cId":10},{"province":"黑龙江","city":"鹤岗","pId":4,"cId":11},{"province":"黑龙江","city":"佳木斯","pId":4,"cId":12},{"province":"黑龙江","city":"伊春","pId":4,"cId":13},{"province":"黑龙江","city":"双鸭山","pId":4,"cId":14},{"province":"黑龙江","city":"哈尔滨","pId":4,"cId":15},{"province":"黑龙江","city":"鸡西","pId":4,"cId":16},{"province":"黑龙江","city":"大庆","pId":4,"cId":18},{"province":"黑龙江","city":"七台河","pId":4,"cId":19},{"province":"黑龙江","city":"牡丹江","pId":4,"cId":20},{"province":"吉林","city":"辽源","pId":5,"cId":22},{"province":"吉林","city":"通化","pId":5,"cId":23},{"province":"吉林","city":"白城","pId":5,"cId":24},{"province":"吉林","city":"松原","pId":5,"cId":25},{"province":"吉林","city":"长春","pId":5,"cId":26},{"province":"吉林","city":"吉林市","pId":5,"cId":27},{"province":"吉林","city":"延边朝鲜族自治州","pId":5,"cId":29},{"province":"吉林","city":"白山","pId":5,"cId":31},{"province":"吉林","city":"四平","pId":5,"cId":32},{"province":"辽宁","city":"葫芦岛","pId":6,"cId":33},{"province":"辽宁","city":"盘锦","pId":6,"cId":34},{"province":"辽宁","city":"辽阳","pId":6,"cId":35},{"province":"辽宁","city":"铁岭","pId":6,"cId":36},{"province":"辽宁","city":"阜新","pId":6,"cId":37},{"province":"辽宁","city":"朝阳","pId":6,"cId":38},{"province":"辽宁","city":"锦州","pId":6,"cId":39},{"province":"辽宁","city":"鞍山","pId":6,"cId":40},{"province":"辽宁","city":"沈阳","pId":6,"cId":41},{"province":"辽宁","city":"本溪","pId":6,"cId":42},{"province":"辽宁","city":"抚顺","pId":6,"cId":43},{"province":"辽宁","city":"营口","pId":6,"cId":44},{"province":"辽宁","city":"丹东","pId":6,"cId":45},{"province":"辽宁","city":"大连","pId":6,"cId":47},{"province":"内蒙古","city":"呼伦贝尔","pId":7,"cId":48},{"province":"内蒙古","city":"兴安盟","pId":7,"cId":49},{"province":"内蒙古","city":"锡林郭勒盟","pId":7,"cId":50},{"province":"内蒙古","city":"巴彦淖尔","pId":7,"cId":51},{"province":"内蒙古","city":"包头","pId":7,"cId":52},{"province":"内蒙古","city":"呼和浩特","pId":7,"cId":53},{"province":"内蒙古","city":"通辽","pId":7,"cId":55},{"province":"内蒙古","city":"赤峰","pId":7,"cId":56},{"province":"内蒙古","city":"乌海","pId":7,"cId":57},{"province":"内蒙古","city":"鄂尔多斯","pId":7,"cId":58},{"province":"内蒙古","city":"乌兰察布","pId":7,"cId":59},{"province":"宁夏","city":"石嘴山","pId":8,"cId":60},{"province":"宁夏","city":"银川","pId":8,"cId":61},{"province":"宁夏","city":"吴忠","pId":8,"cId":62},{"province":"宁夏","city":"固原","pId":8,"cId":63},{"province":"甘肃","city":"张掖","pId":9,"cId":64},{"province":"甘肃","city":"金昌","pId":9,"cId":65},{"province":"甘肃","city":"武威","pId":9,"cId":66},{"province":"甘肃","city":"兰州","pId":9,"cId":67},{"province":"甘肃","city":"白银","pId":9,"cId":68},{"province":"甘肃","city":"定西","pId":9,"cId":69},{"province":"甘肃","city":"平凉","pId":9,"cId":70},{"province":"甘肃","city":"庆阳","pId":9,"cId":71},{"province":"甘肃","city":"甘南藏族自治州","pId":9,"cId":72},{"province":"甘肃","city":"临夏回族自治州","pId":9,"cId":73},{"province":"甘肃","city":"天水","pId":9,"cId":74},{"province":"甘肃","city":"嘉峪关","pId":9,"cId":75},{"province":"甘肃","city":"酒泉","pId":9,"cId":76},{"province":"甘肃","city":"陇南","pId":9,"cId":77},{"province":"新疆","city":"昌吉回族自治州","pId":10,"cId":78},{"province":"新疆","city":"克孜勒苏柯尔克孜自治州","pId":10,"cId":79},{"province":"新疆","city":"伊犁哈萨克自治州","pId":10,"cId":80},{"province":"新疆","city":"阿拉尔","pId":10,"cId":81},{"province":"新疆","city":"克拉玛依","pId":10,"cId":82},{"province":"新疆","city":"博尔塔拉蒙古自治州","pId":10,"cId":83},{"province":"新疆","city":"乌鲁木齐","pId":10,"cId":84},{"province":"新疆","city":"吐鲁番","pId":10,"cId":85},{"province":"新疆","city":"阿克苏地区","pId":10,"cId":86},{"province":"新疆","city":"石河子","pId":10,"cId":87},{"province":"新疆","city":"喀什地区","pId":10,"cId":88},{"province":"新疆","city":"和田地区","pId":10,"cId":89},{"province":"新疆","city":"哈密","pId":10,"cId":90},{"province":"陕西","city":"榆林","pId":11,"cId":92},{"province":"陕西","city":"延安","pId":11,"cId":93},{"province":"陕西","city":"咸阳","pId":11,"cId":94},{"province":"陕西","city":"西安","pId":11,"cId":95},{"province":"陕西","city":"渭南","pId":11,"cId":96},{"province":"陕西","city":"汉中","pId":11,"cId":97},{"province":"陕西","city":"商洛","pId":11,"cId":98},{"province":"陕西","city":"安康","pId":11,"cId":99},{"province":"陕西","city":"铜川","pId":11,"cId":100},{"province":"陕西","city":"宝鸡","pId":11,"cId":101},{"province":"山西","city":"长治","pId":12,"cId":102},{"province":"山西","city":"晋中","pId":12,"cId":103},{"province":"山西","city":"朔州","pId":12,"cId":104},{"province":"山西","city":"大同","pId":12,"cId":105},{"province":"山西","city":"吕梁","pId":12,"cId":106},{"province":"山西","city":"忻州","pId":12,"cId":107},{"province":"山西","city":"太原","pId":12,"cId":108},{"province":"山西","city":"阳泉","pId":12,"cId":109},{"province":"山西","city":"临汾","pId":12,"cId":110},{"province":"山西","city":"运城","pId":12,"cId":111},{"province":"山西","city":"晋城","pId":12,"cId":112},{"province":"山东","city":"德州","pId":13,"cId":114},{"province":"山东","city":"滨州","pId":13,"cId":115},{"province":"山东","city":"烟台","pId":13,"cId":116},{"province":"山东","city":"聊城","pId":13,"cId":117},{"province":"山东","city":"济南","pId":13,"cId":118},{"province":"山东","city":"泰安","pId":13,"cId":119},{"province":"山东","city":"淄博","pId":13,"cId":120},{"province":"山东","city":"潍坊","pId":13,"cId":121},{"province":"山东","city":"青岛","pId":13,"cId":122},{"province":"山东","city":"济宁","pId":13,"cId":123},{"province":"山东","city":"日照","pId":13,"cId":124},{"province":"山东","city":"枣庄","pId":13,"cId":126},{"province":"山东","city":"东营","pId":13,"cId":127},{"province":"山东","city":"威海","pId":13,"cId":128},{"province":"山东","city":"莱芜","pId":13,"cId":129},{"province":"山东","city":"临沂","pId":13,"cId":130},{"province":"山东","city":"菏泽","pId":13,"cId":131},{"province":"河北","city":"邯郸","pId":14,"cId":132},{"province":"河北","city":"衡水","pId":14,"cId":133},{"province":"河北","city":"石家庄","pId":14,"cId":134},{"province":"河北","city":"邢台","pId":14,"cId":135},{"province":"河北","city":"张家口","pId":14,"cId":136},{"province":"河北","city":"承德","pId":14,"cId":137},{"province":"河北","city":"秦皇岛","pId":14,"cId":138},{"province":"河北","city":"廊坊","pId":14,"cId":139},{"province":"河北","city":"唐山","pId":14,"cId":140},{"province":"河北","city":"保定","pId":14,"cId":141},{"province":"河北","city":"沧州","pId":14,"cId":142},{"province":"河南","city":"安阳","pId":15,"cId":143},{"province":"河南","city":"三门峡","pId":15,"cId":144},{"province":"河南","city":"郑州","pId":15,"cId":145},{"province":"河南","city":"南阳","pId":15,"cId":146},{"province":"河南","city":"周口","pId":15,"cId":147},{"province":"河南","city":"驻马店","pId":15,"cId":148},{"province":"河南","city":"信阳","pId":15,"cId":149},{"province":"河南","city":"开封","pId":15,"cId":150},{"province":"河南","city":"洛阳","pId":15,"cId":151},{"province":"河南","city":"平顶山","pId":15,"cId":152},{"province":"河南","city":"焦作","pId":15,"cId":153},{"province":"河南","city":"鹤壁","pId":15,"cId":154},{"province":"河南","city":"新乡","pId":15,"cId":155},{"province":"河南","city":"濮阳","pId":15,"cId":156},{"province":"河南","city":"许昌","pId":15,"cId":157},{"province":"河南","city":"漯河","pId":15,"cId":158},{"province":"河南","city":"商丘","pId":15,"cId":159},{"province":"河南","city":"济源","pId":15,"cId":160},{"province":"西藏","city":"那曲","pId":16,"cId":161},{"province":"西藏","city":"日喀则","pId":16,"cId":162},{"province":"西藏","city":"拉萨","pId":16,"cId":163},{"province":"西藏","city":"山南","pId":16,"cId":164},{"province":"西藏","city":"阿里地区","pId":16,"cId":165},{"province":"西藏","city":"昌都","pId":16,"cId":166},{"province":"西藏","city":"林芝","pId":16,"cId":167},{"province":"云南","city":"昭通","pId":17,"cId":168},{"province":"云南","city":"丽江","pId":17,"cId":169},{"province":"云南","city":"曲靖","pId":17,"cId":170},{"province":"云南","city":"保山","pId":17,"cId":171},{"province":"云南","city":"大理白族自治州","pId":17,"cId":172},{"province":"云南","city":"楚雄彝族自治州","pId":17,"cId":173},{"province":"云南","city":"昆明","pId":17,"cId":174},{"province":"云南","city":"玉溪","pId":17,"cId":176},{"province":"云南","city":"临沧","pId":17,"cId":177},{"province":"云南","city":"普洱","pId":17,"cId":178},{"province":"云南","city":"红河哈尼族彝族自治州","pId":17,"cId":179},{"province":"云南","city":"文山壮族苗族自治州","pId":17,"cId":180},{"province":"云南","city":"西双版纳傣族自治州","pId":17,"cId":181},{"province":"云南","city":"德宏傣族景颇族自治州","pId":17,"cId":182},{"province":"云南","city":"怒江傈僳族自治州","pId":17,"cId":183},{"province":"云南","city":"迪庆藏族自治州","pId":17,"cId":184},{"province":"四川","city":"甘孜藏族自治州","pId":18,"cId":185},{"province":"四川","city":"阿坝藏族羌族自治州","pId":18,"cId":186},{"province":"四川","city":"凉山彝族自治州","pId":18,"cId":187},{"province":"四川","city":"成都","pId":18,"cId":188},{"province":"四川","city":"绵阳","pId":18,"cId":189},{"province":"四川","city":"雅安","pId":18,"cId":190},{"province":"四川","city":"乐山","pId":18,"cId":192},{"province":"四川","city":"宜宾","pId":18,"cId":193},{"province":"四川","city":"巴中","pId":18,"cId":194},{"province":"四川","city":"达州","pId":18,"cId":195},{"province":"四川","city":"遂宁","pId":18,"cId":196},{"province":"四川","city":"南充","pId":18,"cId":197},{"province":"四川","city":"泸州","pId":18,"cId":198},{"province":"四川","city":"自贡","pId":18,"cId":199},{"province":"四川","city":"攀枝花","pId":18,"cId":200},{"province":"四川","city":"德阳","pId":18,"cId":201},{"province":"四川","city":"广元","pId":18,"cId":202},{"province":"四川","city":"内江","pId":18,"cId":203},{"province":"四川","city":"广安","pId":18,"cId":204},{"province":"四川","city":"眉山","pId":18,"cId":205},{"province":"四川","city":"资阳","pId":18,"cId":206},{"province":"贵州","city":"毕节","pId":19,"cId":207},{"province":"贵州","city":"遵义","pId":19,"cId":208},{"province":"贵州","city":"铜仁","pId":19,"cId":209},{"province":"贵州","city":"安顺","pId":19,"cId":210},{"province":"贵州","city":"贵阳","pId":19,"cId":211},{"province":"贵州","city":"黔西南布依族苗族自治州","pId":19,"cId":212},{"province":"贵州","city":"六盘水","pId":19,"cId":213},{"province":"广西","city":"桂林","pId":20,"cId":214},{"province":"广西","city":"河池","pId":20,"cId":215},{"province":"广西","city":"柳州","pId":20,"cId":216},{"province":"广西","city":"百色","pId":20,"cId":217},{"province":"广西","city":"贵港","pId":20,"cId":218},{"province":"广西","city":"梧州","pId":20,"cId":219},{"province":"广西","city":"南宁","pId":20,"cId":220},{"province":"广西","city":"钦州","pId":20,"cId":221},{"province":"广西","city":"崇左","pId":20,"cId":222},{"province":"广西","city":"北海","pId":20,"cId":223},{"province":"广西","city":"防城港","pId":20,"cId":224},{"province":"广西","city":"玉林","pId":20,"cId":225},{"province":"广西","city":"贺州","pId":20,"cId":226},{"province":"广西","city":"来宾","pId":20,"cId":227},{"province":"广东","city":"韶关","pId":21,"cId":229},{"province":"广东","city":"清远","pId":21,"cId":230},{"province":"广东","city":"梅州","pId":21,"cId":231},{"province":"广东","city":"肇庆","pId":21,"cId":232},{"province":"广东","city":"广州","pId":21,"cId":233},{"province":"广东","city":"惠州","pId":21,"cId":234},{"province":"广东","city":"河源","pId":21,"cId":235},{"province":"广东","city":"汕头","pId":21,"cId":236},{"province":"广东","city":"深圳","pId":21,"cId":237},{"province":"广东","city":"汕尾","pId":21,"cId":238},{"province":"广东","city":"湛江","pId":21,"cId":239},{"province":"广东","city":"阳江","pId":21,"cId":240},{"province":"广东","city":"茂名","pId":21,"cId":241},{"province":"广东","city":"珠海","pId":21,"cId":246},{"province":"广东","city":"佛山","pId":21,"cId":247},{"province":"广东","city":"江门","pId":21,"cId":248},{"province":"广东","city":"东莞","pId":21,"cId":249},{"province":"广东","city":"中山","pId":21,"cId":250},{"province":"广东","city":"潮州","pId":21,"cId":251},{"province":"广东","city":"揭阳","pId":21,"cId":252},{"province":"广东","city":"云浮","pId":21,"cId":253},{"province":"福建","city":"莆田","pId":22,"cId":254},{"province":"福建","city":"南平","pId":22,"cId":256},{"province":"福建","city":"宁德","pId":22,"cId":257},{"province":"福建","city":"福州","pId":22,"cId":258},{"province":"福建","city":"龙岩","pId":22,"cId":259},{"province":"福建","city":"三明","pId":22,"cId":260},{"province":"福建","city":"泉州","pId":22,"cId":261},{"province":"福建","city":"漳州","pId":22,"cId":262},{"province":"福建","city":"厦门","pId":22,"cId":263},{"province":"湖南","city":"张家界","pId":23,"cId":264},{"province":"湖南","city":"岳阳","pId":23,"cId":265},{"province":"湖南","city":"怀化","pId":23,"cId":266},{"province":"湖南","city":"长沙","pId":23,"cId":267},{"province":"湖南","city":"邵阳","pId":23,"cId":268},{"province":"湖南","city":"益阳","pId":23,"cId":269},{"province":"湖南","city":"郴州","pId":23,"cId":270},{"province":"湖南","city":"株洲","pId":23,"cId":274},{"province":"湖南","city":"湘潭","pId":23,"cId":275},{"province":"湖南","city":"衡阳","pId":23,"cId":276},{"province":"湖南","city":"娄底","pId":23,"cId":277},{"province":"湖南","city":"常德","pId":23,"cId":278},{"province":"湖北","city":"荆门","pId":24,"cId":280},{"province":"湖北","city":"荆州","pId":24,"cId":281},{"province":"湖北","city":"黄冈","pId":24,"cId":282},{"province":"湖北","city":"恩施土家族苗族自治州","pId":24,"cId":283},{"province":"湖北","city":"武汉","pId":24,"cId":284},{"province":"湖北","city":"黄石","pId":24,"cId":285},{"province":"湖北","city":"鄂州","pId":24,"cId":286},{"province":"湖北","city":"孝感","pId":24,"cId":287},{"province":"湖北","city":"咸宁","pId":24,"cId":288},{"province":"湖北","city":"随州","pId":24,"cId":289},{"province":"湖北","city":"仙桃","pId":24,"cId":290},{"province":"湖北","city":"天门","pId":24,"cId":291},{"province":"湖北","city":"潜江","pId":24,"cId":292},{"province":"湖北","city":"神农架林区","pId":24,"cId":293},{"province":"江西","city":"萍乡","pId":25,"cId":298},{"province":"江西","city":"新余","pId":25,"cId":299},{"province":"江西","city":"宜春","pId":25,"cId":300},{"province":"江西","city":"赣州","pId":25,"cId":301},{"province":"江西","city":"九江","pId":25,"cId":302},{"province":"江西","city":"景德镇","pId":25,"cId":303},{"province":"江西","city":"南昌","pId":25,"cId":304},{"province":"江西","city":"鹰潭","pId":25,"cId":305},{"province":"江西","city":"上饶","pId":25,"cId":306},{"province":"江西","city":"抚州","pId":25,"cId":307},{"province":"浙江","city":"湖州","pId":26,"cId":308},{"province":"浙江","city":"舟山","pId":26,"cId":314},{"province":"浙江","city":"杭州","pId":26,"cId":315},{"province":"浙江","city":"嘉兴","pId":26,"cId":316},{"province":"浙江","city":"金华","pId":26,"cId":318},{"province":"浙江","city":"绍兴","pId":26,"cId":319},{"province":"浙江","city":"宁波","pId":26,"cId":320},{"province":"浙江","city":"衢州","pId":26,"cId":321},{"province":"浙江","city":"丽水","pId":26,"cId":322},{"province":"浙江","city":"台州","pId":26,"cId":323},{"province":"浙江","city":"温州","pId":26,"cId":324},{"province":"江苏","city":"无锡","pId":27,"cId":325},{"province":"江苏","city":"苏州","pId":27,"cId":326},{"province":"江苏","city":"镇江","pId":27,"cId":331},{"province":"江苏","city":"泰州","pId":27,"cId":332},{"province":"江苏","city":"宿迁","pId":27,"cId":333},{"province":"江苏","city":"徐州","pId":27,"cId":334},{"province":"江苏","city":"连云港","pId":27,"cId":335},{"province":"江苏","city":"淮安","pId":27,"cId":336},{"province":"江苏","city":"南京","pId":27,"cId":337},{"province":"江苏","city":"扬州","pId":27,"cId":338},{"province":"江苏","city":"盐城","pId":27,"cId":339},{"province":"江苏","city":"南通","pId":27,"cId":340},{"province":"江苏","city":"常州","pId":27,"cId":341},{"province":"安徽","city":"淮南","pId":28,"cId":342},{"province":"安徽","city":"马鞍山","pId":28,"cId":343},{"province":"安徽","city":"淮北","pId":28,"cId":344},{"province":"安徽","city":"铜陵","pId":28,"cId":345},{"province":"安徽","city":"滁州","pId":28,"cId":346},{"province":"安徽","city":"池州","pId":28,"cId":348},{"province":"安徽","city":"宣城","pId":28,"cId":349},{"province":"安徽","city":"亳州","pId":28,"cId":350},{"province":"安徽","city":"宿州","pId":28,"cId":351},{"province":"安徽","city":"阜阳","pId":28,"cId":352},{"province":"安徽","city":"六安","pId":28,"cId":353},{"province":"安徽","city":"蚌埠","pId":28,"cId":354},{"province":"安徽","city":"合肥","pId":28,"cId":355},{"province":"安徽","city":"芜湖","pId":28,"cId":356},{"province":"安徽","city":"安庆","pId":28,"cId":357},{"province":"安徽","city":"黄山","pId":28,"cId":358},{"province":"青海","city":"海北藏族自治州","pId":29,"cId":359},{"province":"青海","city":"海南藏族自治州","pId":29,"cId":360},{"province":"青海","city":"西宁","pId":29,"cId":361},{"province":"青海","city":"玉树藏族自治州","pId":29,"cId":362},{"province":"青海","city":"黄南藏族自治州","pId":29,"cId":363},{"province":"青海","city":"果洛藏族自治州","pId":29,"cId":364},{"province":"青海","city":"海西蒙古族藏族自治州","pId":29,"cId":365},{"province":"青海","city":"海东","pId":29,"cId":366},{"province":"海南","city":"海口","pId":30,"cId":367},{"province":"海南","city":"三亚","pId":30,"cId":368},{"province":"内蒙古","city":"阿拉善盟","pId":7,"cId":389},{"province":"宁夏","city":"中卫","pId":8,"cId":393},{"province":"新疆","city":"塔城地区","pId":10,"cId":397},{"province":"新疆","city":"阿勒泰地区","pId":10,"cId":398},{"province":"贵州","city":"黔南布依族苗族自治州","pId":19,"cId":407},{"province":"贵州","city":"黔东南苗族侗族自治州","pId":19,"cId":408},{"province":"湖南","city":"永州","pId":23,"cId":410},{"province":"湖南","city":"湘西土家族苗族自治州","pId":23,"cId":411},{"province":"湖北","city":"宜昌","pId":24,"cId":412},{"province":"湖北","city":"襄阳","pId":24,"cId":413},{"province":"湖北","city":"十堰","pId":24,"cId":414},{"province":"江西","city":"吉安","pId":25,"cId":416},{"province":"新疆","city":"巴音郭楞蒙古自治州","pId":10,"cId":419},{"province":"内蒙古","city":"乌兰浩特","pId":7,"cId":433},{"province":"新疆","city":"五家渠","pId":10,"cId":458},{"province":"海南","city":"文昌","pId":30,"cId":460},{"province":"海南","city":"昌江黎族自治县","pId":30,"cId":461},{"province":"海南","city":"乐东黎族自治县","pId":30,"cId":462},{"province":"海南","city":"儋州","pId":30,"cId":463},{"province":"海南","city":"万宁","pId":30,"cId":464},{"province":"海南","city":"陵水黎族自治县","pId":30,"cId":465},{"province":"海南","city":"定安县","pId":30,"cId":466},{"province":"海南","city":"东方","pId":30,"cId":467},{"province":"海南","city":"澄迈县","pId":30,"cId":468},{"province":"新疆","city":"北屯","pId":10,"cId":469},{"province":"海南","city":"琼中黎族苗族自治县","pId":30,"cId":470},{"province":"海南","city":"保亭黎族苗族自治县","pId":30,"cId":471},{"province":"海南","city":"屯昌县","pId":30,"cId":472},{"province":"新疆","city":"双河","pId":10,"cId":473},{"province":"新疆","city":"图木舒克","pId":10,"cId":474},{"province":"海南","city":"琼海","pId":30,"cId":475},{"province":"海南","city":"五指山","pId":30,"cId":476},{"province":"海南","city":"临高县","pId":30,"cId":477},{"province":"海南","city":"白沙黎族自治县","pId":30,"cId":478}
因此根据以上规则我们需要设置正确的 province 和 city，尽量选中江浙地区，因为这些地区的 IP 会多一些，具体的参数设置如下图所示：

​
代码示例

可以发现，在页面右侧已经自动生成了各种语言的代码，如图所示：

部分代码示例如下：

​
CURL

curl -X POST 'https://api.acedata.cloud/adsl/extract' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "province": "浙江",
  "city": "温州"
}'

​
Python

import requests

url = "https://api.acedata.cloud/adsl/extract"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "province": "浙江",
    "city": "温州"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
响应示例

请求成功后，API 将返回换脸后端图片结果信息。例如： 
{
  "success": true,
  "data": [
    {
      "ip": "115.219.4.171",
      "port": 23456,
      "proxy": "115.219.4.171:23456",
      "outbound_ip": "115.219.4.171",
      "province": "浙江",
      "city": "温州",
      "expire_at": 1721877364.588,
      "dialed_at": 1721876984.588
    }
  ],
  "trace_id": "406465b0-f086-4a12-87a7-cdf05a3930a1"
}
可以看到，结果中有一个 data 字段，里面包含了此处提取 IP 任务的详细，其它信息如下图所示：
  • success ，此处提取 ADSL 的 IP 任务的结果状态。
  • data，提取后的 ADSL 的 IP 详细信息。
从 data 中可以明显看到这个 IP 的详细信息，主要信息中 ip 表示此次提取到的 IP 地址，其它信息如下：
  • ip，此处提取 ADSL 的 IP 地址。
  • port，此处提取 ADSL 的 IP 端口信息。
  • proxy，提取后的 ADSL 的 IP 代理的完整信息。
  • province，提取后的 ADSL 的 IP 所在省份。
  • city，提取后的 ADSL 的 IP 所在城市。
可以看到我们可以轻松使用上面 proxy 来进行下一步 IP 代理工作。 首先在使用 IP 代理之前我们需要将自己的网络 IP 地址（获取本地网络 IP 方法请自行查找）添加到下文的白名单之中，接下来讲一下 IP 代理如何使用：

​
使用代理

注意：使用提取到的代理 IP 之前，请务必添加 IP 白名单，否则无法使用，关于添加白名单的说明请参考下文内容。
Curl 示例代码： 
curl -x 115.219.4.171:23456 myip.vpsnb.net # http proxy
curl --socks5 115.219.3.54:23457 myip.vpsnb.net # socks proxy
Python 示例代理： 
import requests
import socks
import socket
import time


def test_http_proxy(proxy):
    try:
        start_time = time.time()
        response = requests.get(
            'http://httpbin.org/ip', proxies={'http': proxy, 'https': proxy}, timeout=100)
        elapsed_time = time.time() - start_time
        print(response)
        if response.status_code == 200:
            print(f"HTTP Proxy {proxy} success. time: {elapsed_time:.2f} s")
            print(f"IP: {response.json()['origin']}")
        else:
            print(f"HTTP Proxy {proxy} failed. code: {response.status_code}")
    except Exception as e:
        print(f"HTTP Proxy {proxy} failed: {str(e)}")


def test_socks_proxy(proxy):
    proxy_parts = proxy.split(':')
    if len(proxy_parts) != 2:
        print(f"SOCKS failed: {proxy}")
        return

    host, port = proxy_parts
    port = int(port)

    try:
        start_time = time.time()
        socks.set_default_proxy(socks.SOCKS5, host, port)
        socket.socket = socks.socksocket
        response = requests.get('http://httpbin.org/ip', timeout=10)
        elapsed_time = time.time() - start_time

        if response.status_code == 200:
            print(f"SOCKS Proxy {proxy} success. time: {elapsed_time:.2f} s")
            print(f"IP: {response.json()['origin']}")
        else:
            print(f"SOCKS Proxy {proxy} failed. code: {response.status_code}")
    except Exception as e:
        print(f"SOCKS Proxy {proxy} failed: {str(e)}")
    finally:
        socks.set_default_proxy()
        socket.socket = socket.socket


if __name__ == "__main__":
    # HTTP Proxy
    http_proxy = "http://115.219.4.171:23456"
    test_http_proxy(http_proxy)

    # SOCKS Proxy
    socks_proxy = "115.219.3.54:23457"
    test_socks_proxy(socks_proxy)

​
响应示例

{
  "ip": "115.219.4.171",
  "country": "中国",
  "area": "0",
  "province": "浙江省",
  "city": "温州市",
  "isp": "电信",
  "timestamp": 1721877261
}
从上面结果可知，获得的结果与提取时的地区信息是一致的，表示该 ADSL IP 代理是成功有效的。

​
ADSL 代理类型 type

我们还可以设置 ADSL 的 IP 代理类型，主要分为俩种，第一种是 http，另一种是 socks，因为第一种是默认使用的，接下来我们以第二种为示例，我们可以进行下面的设置。 下面设置 IP 代理的类型为 socks ，具体设置如下图：

同时您可以注意到右侧有对应的调用代码生成，您可以复制代码直接运行，也可以直接点击「Try」按钮进行测试。

Python 样例调用代码： 
import requests

url = "https://api.acedata.cloud/adsl/extract"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "province": "浙江",
    "city": "温州",
    "type": "socks"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
调用之后，我们发现返回结果如下： 
{
  "success": true,
  "data": [
    {
      "ip": "115.222.155.148",
      "port": 23457,
      "proxy": "115.222.155.148:23457",
      "outbound_ip": "115.222.155.148",
      "province": "浙江",
      "city": "温州",
      "expire_at": 1721808226.561,
      "dialed_at": 1721807846.561
    }
  ],
  "trace_id": "27d06ff5-20e9-4476-bdda-9e72a54ac0d4"
}
返回的结果与上文的内容一致，可以看到此时提取到的 ADSL 的 IP 代理类型是 socks ，因此在后续的工作需要根据代理的类型来进行使用 IP 代理服务。

​
添加 IP 白名单

接下来就可以在界面上填写对应的内容，如图所示：

在第一次使用该接口时，我们至少需要填写三个内容，一个是 authorization，直接在下拉列表里面选择即可。另一个参数是 ip， ip 就是我们需要使用上文提取到的 IP 代理的本机网络地址。最后一个参数是action，action 是我们对白名单进行的操作，这里是对白名单进行添加的操作。 同时您可以注意到右侧有对应的调用代码生成，您可以复制代码直接运行，也可以直接点击「Try」按钮进行测试。

Python 样例调用代码： 
import requests

url = "https://api.acedata.cloud/adsl/whitelist"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "ip": "113.112.122.132",
    "action": "add"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
调用之后，我们发现返回结果如下： 
{
  "success": true
}
返回结果一共有一个字段，介绍如下：
  • success ，此处操作结果的状态。
其中 success 是包含了操作结果的状态，我们可以看到将 IP 113.112.122.132 已经成功添加到白名单内。

​
错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：
  • 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token：Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests：Too many requests, you have exceeded the rate limit.
  • 500 api_error：Internal server error, something went wrong on the server.

​
错误响应示例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
结论

通过本文档，您已经了解了如何使用 ADSL Proxy API 轻松提取 ADSL 的 IP 并且对 ADSL Proxy 添加 IP 白名单。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。