读取白名单 IP 列表

接口描述：分页查询白名单 IP 列表，可按类型、状态、IP 或创建时间筛选。

请求方式：POST

请求 URL：https://api.dataify.com/api/open/white_list/list

请求参数：

字段	类型	必填	说明
type	int	否	用户类型：1 住宅，2 高带宽
page	int	否	页码，默认 1
page_size	int	否	每页数量，默认 10，最大 1000
ip	string	否	IP 搜索
status	int	否	状态，1 正常，2 禁用
start_time	int64	否	创建开始时间戳（秒）
end_time	int64	否	创建结束时间戳（秒）

请求示例：

{
  "type": 1,
  "page": 1,
  "page_size": 20
}

返回字段

字段	类型	说明
list	array	白名单 IP 列表
total	int64	总数
page	int	当前页码
page_size	int	每页数量

list 中字段：

字段	类型	说明
ip	string	白名单 IP
status	int	状态：1 正常，2 禁用
created_at	int64	创建时间戳（秒）
mark	string	备注

返回示例：

{
  "code": 200,
  "data": {
    "list": [
      {
        "ip": "203.0.113.10",
        "status": 1,
        "created_at": "2026-05-25 10:00:00",
        "mark": "office"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  },
  "message": "success",
  "timestamp": 1710000001
}

备注：

type 默认 1（住宅）。

支持分页查询，page 和 page_size 控制返回结果。

可根据 ip 模糊搜索或 status 筛选状态。

created_at 为 UNIX 时间戳，前端可转换为可读日期。

读取白名单 IP 列表

读取白名单 IP 列表#

返回字段#

读取白名单 IP 列表

返回字段