# API

### 1024Proxy API功能介绍

API功能为有编程能力的用户提供了更加便捷的操作方式。可以通过修改API参数快速筛选提取自己需要的代理IP。使用1024Proxy API更常被应用于数据抓取等需要高频切换IP的业务场景。

### 快速了解

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2FpG2NwdimCgiNXDSYGw7f%2F1.png?alt=media&#x26;token=db8ce0da-3972-4937-98fe-4e7abba94016" alt=""><figcaption></figcaption></figure>

### 如何使用1024Proxy的API功能

{% stepper %}
{% step %}

### 添加本地公网IP至IP白名单，点击按钮【添加白名单】

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2FnxuPkIPOTz6GdSloJkPP%2F2.png?alt=media&#x26;token=424df935-0de9-4f58-8190-00e379e8cc85" alt=""><figcaption></figcaption></figure>

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2FxfEukQhGCduxZV23l9mq%2F3.png?alt=media&#x26;token=513452c8-97a1-4676-91ec-2ffd59691b2d" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### 完成动态住宅流量套餐的购买

返回API模式菜单下，选中动态住宅流量，我们可以查看到当前已经添加我们的本地公网IP至IP白名单中。点击立即购买跳转到套餐购买页，完成动态住宅流量的套餐购买。

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2FbFYGkJDpai1mp9x3JUKB%2F4.png?alt=media&#x26;token=b038dc51-29b3-4ebd-9a0f-c3a132a5de1d" alt=""><figcaption></figcaption></figure>

选择需要的套餐类型

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2FWLeXfyfZRL1qf1NndlK7%2F5.png?alt=media&#x26;token=479bb0c2-989d-4adc-8e65-e406c18fe6a4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 设置筛选条件或者参数

完成购买后点击进入控制台进入API模式，

![](https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2Fxf7iYFsqEGOv8QlELARS%2F6.png?alt=media\&token=d56d229b-ec4c-4700-9166-99b7709a47c0)

可以查看到我们购买的动态住宅流量及当前账号中剩余的流量。

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2FSUvptJ4GfhNyrfeB4sbD%2F7.png?alt=media&#x26;token=181c1b7e-c940-4ca4-aea8-6b841a75f001" alt=""><figcaption></figcaption></figure>

通过修改下面的参数完成API的基础设置后即可使用API链接批量修改提取自己需要的IP。

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2FHDIyAwh1usdDKZ6X98wL%2F8.png?alt=media&#x26;token=36e6945c-d540-4334-91e7-c876fa738c34" alt=""><figcaption></figcaption></figure>

1.国家/地区：通过下拉框修改国家代码即可修改API链接对应的region参数，下拉选择的可视化操作方便小白用户操作。

2.分隔符：1024Proxy支持多种API分隔符，能够适用于多种业务场景。

3.会话类型：1024Proxy包含两种会话类型：粘性会话模式（Sticky mode）和轮换会话模式（Rotating mode），在动态住宅流量的粘性会话模式下，会话时长为10/15分钟。选择粘性会话模式，则API将多一个time参数。

4.数据格式：这里的数据格式是指，API返回的数据对应着不同的数据返回数据格式。在1024Proxy官网展示着对应的数据返回示例。在API参数中对应的参数为type。

5.数量：这里的数量表示的API链接提取的IP数量，对应的API 修改参数为num。

6.API链接：通过修改对应的参数可以修改IP的提取条件。复制API链接到编程程序或者第三方代理软件中即可使用。

7.返回示例：返回的示例数据格式对应上述的txt和json两种数据格式的返回数据示例。
{% endstep %}
{% endstepper %}

### 参数注释

| 参数名    | 说明                     | 类型     | 必选 |
| ------ | ---------------------- | ------ | -- |
| region | 国家                     | int    | 是  |
| format | 返回数据格式分割符，n=\n rn=\r\n | string | 是  |
| time   | 会话时长                   | int    | 是  |
| num    | 提取 IP 数量               | string | 否  |
| type   | 数据格式：txt json          | string | 否  |