> 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/add-to-whitelist.md).

# 添加白名单

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

> 添加静态网络白名单 IP（支持 IPv4/IPv6）。每账号每种产品最多 50 条。

```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/create":{"post":{"description":"添加静态网络白名单 IP（支持 IPv4/IPv6）。每账号每种产品最多 50 条。","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"integer","description":"1 静态 ISP；2 数据中心。默认 1。","enum":[1,2],"default":1},"ip":{"type":"string","description":"一个或多个 IPv4 / IPv6 地址。多个地址可用英文逗号、分号或换行分隔；最长 5000 字符。","maxLength":5000},"mark":{"type":"string","description":"备注，最长 200 字符。","maxLength":200}},"required":["ip"]}}},"required":true,"description":"请求参数"},"responses":{"200":{"description":"返回示例","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"请求处理状态码，200 表示成功。"},"data":{"type":"object","properties":{"created":{"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":"本次新建的记录，含 id、ip、status、created_at、mark。"},"created_count":{"type":"integer","description":"新建数量。"},"reactivated_count":{"type":"integer","description":"恢复本人已删除记录的数量。"},"duplicates":{"type":"array","items":{"type":"string"},"description":"本账号已存在的地址。"},"occupied":{"type":"array","items":{"type":"string"},"description":"已被其他账号占用的地址。"},"invalid":{"type":"array","items":{"type":"string"},"description":"格式无效的地址。"}}},"message":{"type":"string","description":"响应消息。"},"timestamp":{"type":"integer","format":"int64","description":"响应生成时间，Unix 秒。"}}}}}}}}}}}
```