> ## Documentation Index
> Fetch the complete documentation index at: https://doc.ispkey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 添加白名单

`GET` /api/whitelist/add

**[白名单列表页面，点击跳转](https://ispkey.com/admin/whitelist/list)**

**请求参数**

| 名称     | 类型     | 必选 | 说明           |
| ------ | ------ | -- | ------------ |
| appKey | string | 是  | 密钥           |
| ip     | string | 是  | IP地址，格式：IPv4 |

```url theme={null}
https://open.ispkey.com/whitelist/add?appKey=xxx&ip=12.12.12.12
```

**响应结果**

| 名称   | 类型     | 说明   |
| ---- | ------ | ---- |
| code | int    | 响应代码 |
| msg  | string | 响应消息 |

<Tabs>
  <Tab title="成功">
    ```JSON theme={null}
    {
        "code": 0,
        "msg": "success"
    }
    ```
  </Tab>

  <Tab title="失败">
    ```JSON theme={null}
    {
      "code": 1,
      "msg": "<string>"
    }
    ```
  </Tab>
</Tabs>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://open.ispkey.com/whitelist/add?appKey=xxx&ip=12.12.12.12' \
  --header 'User-Agent: Apifox/1.0.0 (https://apifox.com)'
  ```

  ```bash Python theme={null}
  import requests

  url = "https://open.ispkey.com/whitelist/add?appKey=xxx&ip=12.12.12.12"

  payload={}
  headers = {
     'User-Agent': 'Apifox/1.0.0 (https://apifox.com)'
  }

  response = requests.request("GET", url, headers=headers, data=payload)

  print(response.text)
  ```

  ```bash PHP theme={null}
  <?php

  $curl = curl_init();

  curl_setopt_array($curl, array(
     CURLOPT_URL => 'https://open.ispkey.com/whitelist/add?appKey=xxx&ip=12.12.12.12',
     CURLOPT_RETURNTRANSFER => true,
     CURLOPT_ENCODING => '',
     CURLOPT_MAXREDIRS => 10,
     CURLOPT_TIMEOUT => 0,
     CURLOPT_FOLLOWLOCATION => true,
     CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
     CURLOPT_CUSTOMREQUEST => 'GET',
     CURLOPT_HTTPHEADER => array(
        'User-Agent: Apifox/1.0.0 (https://apifox.com)'
     ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;
  ```

  ```bash JavaScript theme={null}
  var myHeaders = new Headers();
  myHeaders.append("User-Agent", "Apifox/1.0.0 (https://apifox.com)");

  var requestOptions = {
     method: 'GET',
     headers: myHeaders,
     redirect: 'follow'
  };

  fetch("https://open.ispkey.com/whitelist/add?appKey=xxx&ip=12.12.12.12", requestOptions)
     .then(response => response.text())
     .then(result => console.log(result))
     .catch(error => console.log('error', error));
  ```

  ```bash Go theme={null}
  package main

  import (
     "fmt"
     "net/http"
     "io/ioutil"
  )

  func main() {

     url := "https://open.ispkey.com/whitelist/add?appKey=xxx&ip=12.12.12.12"
     method := "GET"

     client := &http.Client {
     }
     req, err := http.NewRequest(method, url, nil)

     if err != nil {
        fmt.Println(err)
        return
     }
     req.Header.Add("User-Agent", "Apifox/1.0.0 (https://apifox.com)")

     res, err := client.Do(req)
     if err != nil {
        fmt.Println(err)
        return
     }
     defer res.Body.Close()

     body, err := ioutil.ReadAll(res.Body)
     if err != nil {
        fmt.Println(err)
        return
     }
     fmt.Println(string(body))
  }
  ```

  ```bash Java theme={null}
  OkHttpClient client = new OkHttpClient().newBuilder()
     .build();
  MediaType mediaType = MediaType.parse("text/plain");
  RequestBody body = RequestBody.create(mediaType, "");
  Request request = new Request.Builder()
     .url("https://open.ispkey.com/whitelist/add?appKey=xxx&ip=12.12.12.12")
     .method("GET", body)
     .addHeader("User-Agent", "Apifox/1.0.0 (https://apifox.com)")
     .build();
  Response response = client.newCall(request).execute();
  ```
</RequestExample>