> For the complete documentation index, see [llms.txt](https://doc.xspark.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.xspark.cn/api/whitelist-management/get-whitelist-list.md).

# 获取白名单列表

## POST /api/open/white\_list/list

> 获取已添加的白名单列表。

```json
{"openapi":"3.0.3","info":{"title":"xspark-api","version":"1.0.0"},"servers":[{"url":"https://api.xspark.cn"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"ApiKey","description":"在请求头 ApiKey 中填写你的 API KEY。  \n格式：ApiKey: YOUR_API_KEY。  \n请将 YOUR_API_KEY 替换为你的 API KEY 值"}}},"paths":{"/api/open/white_list/list":{"post":{"description":"获取已添加的白名单列表。","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"integer","description":"1 静态 ISP；2 数据中心。默认 1。","enum":[1,2],"default":1},"page":{"type":"integer","description":"页码，默认 1。","default":1},"page_size":{"type":"integer","description":"每页条数，默认 10，最大 100。","default":10,"maximum":100},"ip":{"type":"string","description":"按白名单 IP 地址模糊搜索。"},"status":{"type":"integer","description":"1 启用；2 禁用。","enum":[1,2]},"start_time":{"type":"integer","format":"int64","description":"创建开始时间，Unix 秒。"},"end_time":{"type":"integer","format":"int64","description":"创建结束时间，Unix 秒。"}}}}},"description":"请求参数"},"responses":{"200":{"description":"返回示例","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"请求处理状态码，200 表示成功。"},"data":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"maximum":18446744073709552000,"description":"记录 ID，删除时传入 ids。"},"ip":{"type":"string","description":"白名单 IP 地址。"},"status":{"type":"integer","description":"1 启用；2 禁用。"},"created_at":{"type":"integer","format":"int64","description":"创建时间，Unix 秒。"},"mark":{"type":"string","description":"备注。"}}},"description":"当前页的白名单记录。"},"total":{"type":"integer","format":"int64","description":"符合条件的总记录数。"},"page":{"type":"integer","description":"当前页码。"},"page_size":{"type":"integer","description":"每页条数。"}}},"message":{"type":"string","description":"响应消息。"},"timestamp":{"type":"integer","format":"int64","description":"响应生成时间，Unix 秒。"}}}}}}}}}}}
```