Skip to main content
本文档主要介绍 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，尽量选中江浙地区，因为这些地区的 IP 会多一些，具体的参数设置如下图所示：

​
代码示例

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

部分代码示例如下：

​
CURL

​
Python

​
响应示例

请求成功后，API 将返回换脸后端图片结果信息。例如：
可以看到，结果中有一个 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 示例代码：
Python 示例代理：

​
响应示例

从上面结果可知，获得的结果与提取时的地区信息是一致的，表示该 ADSL IP 代理是成功有效的。

​
ADSL 代理类型 type

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

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

Python 样例调用代码：
调用之后，我们发现返回结果如下：
返回的结果与上文的内容一致，可以看到此时提取到的 ADSL 的 IP 代理类型是 socks ，因此在后续的工作需要根据代理的类型来进行使用 IP 代理服务。

​
添加 IP 白名单

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

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

Python 样例调用代码：
调用之后，我们发现返回结果如下：
返回结果一共有一个字段，介绍如下：
  • 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.

​
错误响应示例

​
结论

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