# 添加白名单 IP

`POST https://api.oxylabs.io/v1/whitelisted_ips`

| 响应    | 说明                                        |
| ----- | ----------------------------------------- |
| `201` | 成功。该 IP 地址已被添加到列表中。响应体包含新添加的 `地址` 和 `id`. |
| `422` | 错误。请求体包含无效的 IP 地址。响应体包含错误消息               |

#### 代码示例

{% tabs %}
{% tab title="cURL" %}

```shell
curl -X POST -u username:password "https://api.oxylabs.io/v1/whitelisted_ips"
--header "Content-Type: application/json" --data '{"address": "127.0.0.1"}'
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://api.oxylabs.io/v1/whitelisted_ips");
$payload = json_encode( array( "address"=> "127.0.0.1" ) );
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $payload);
curl_setopt( $curl, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_USERPWD, 'username:password');

$result = curl_exec($curl);
?>
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
requests.post('https://api.oxylabs.io/v1/whitelisted_ips',
              json={"address": "127.0.0.1"},
              auth=('username', 'password'))
```

{% endtab %}
{% endtabs %}

```
{
    "error": {
        "message": "这不是一个有效的 IP 地址。",
        "code": 422
    }
}
```

#### 示例输出

```
{
    "id": 9767,
    "address": "127.0.0.1"
}
```