ADSL Proxy API 的应用与使用

在现代网络环境中，我们经常需要使用代理来保护我们的隐私或访问特定的内容。ACE数据云提供的ADSL Proxy API，使我们能够方便地提取ADSL IP并将其添加到ADSL Proxy的白名单中。本文将手把手教你如何使用这个API。

简介

ADSL Proxy API 是一种网络服务接口，允许用户提取ADSL IP地址并进行管理。此服务特别适用于需要频繁切换IP的用户，例如网络爬虫、数据采集和匿名浏览等应用场景。

环境准备/前置条件

在开始之前，请确保您已完成以下准备工作： 1. 注册并登录到 ACE 数据云。 2. 获取到 API 的访问凭证。

详细步骤

申请过程

首先，您需要访问 ADSL Proxy Extract API 和 ADSL Proxy Whitelist API 页面，点击“获取”按钮来申请所需的凭证：

如果您未登录，系统会自动引导您登录或注册。首次申请的用户可享受免费额度。

提取 ADSL IP

访问 ADSL Proxy Extract API 接口，填写相应的请求内容。以下是提取ADSL IP的步骤。

设置请求头和请求体

请求头:

• accept: 指定响应结果的格式，设置为application/json。
• authorization: 调用API的密钥，申请后可直接选择。

请求体:

• number: 要提取的ADSL IP数量，默认为1。
• type: 要提取的ADSL IP类型，主要分为http和socks，默认为http。
• province: 提取IP的省份，默认为随机。
• city: 提取IP的城市，默认为随机。

确保province和city的匹配关系，例如：city: 南昌 必须对应province: 江西。具体规则如下：

{"province":"Beijing","city":"Beijing","pId":0,"cId":0}, ...

如图所示，选择江苏或浙江地区，因为这些地区的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": "Zhejiang", "city": "Wenzhou" }'

Python 示例

import requests url = "https://api.acedata.cloud/adsl/extract" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "province": "Zhejiang", "city": "Wenzhou" } 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": "Zhejiang", "city": "Wenzhou", "expire_at": 1721877364.588, "dialed_at": 1721876984.588 } ], "trace_id": "406465b0-f086-4a12-87a7-cdf05a3930a1" }

您可以看到返回的data字段包含提取到的 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): # ... def test_socks_proxy(proxy): # ... 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 白名单

在接口中填写相关信息，注意：

• authorization: 直接从下拉列表中选择。
• ip: 本地网络地址。
• action: 操作类型，此处为添加到白名单。

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)

常见问题

1. 如何处理错误响应？API会返回相应的错误代码和消息，例如：
2. 400 token_mismatched: 请求错误，可能是参数缺失或无效。
3. 401 invalid_token: 未授权，授权令牌无效或缺失。

总结

通过以上步骤，您应该能够轻松提取ADSL IP并将其添加到白名单中。希望本文能帮助您更好地集成和使用ADSL Proxy API。如有问题，请随时联系技术支持团队。

技术标签：ADSL Proxy，API 使用，网络编程，Python，CURL