API 端点
获取 IP 列表 (默认操作)
GET /api/public.php
获取可用拦截规则
GET /api/public.php?action=get_rules
此端点返回一个 JSON 数组，包含了所有可用于筛选的拦截规则名称。
获取可用国家代码
GET /api/public.php?action=get_country_codes
此端点返回一个 JSON 数组，包含了所有可用于筛选的国家代码 (ISO 3166-1 alpha-2)。
参数详解
| 参数 | 描述 | 可选值 | 默认值 |
|---|---|---|---|
sort |
指定 IP 列表的排序方式。 |
|
updated_at_desc |
ip_version |
筛选特定 IP 版本。 | v4, v6 |
(不筛选) |
rule |
根据拦截规则筛选 IP。规则名称需从 get_rules 端点获取。 |
(字符串) | (不筛选) |
country_code |
根据国家代码筛选 IP (ISO 3166-1 alpha-2)。代码需从 get_country_codes 端点获取。 |
(字符串, 如: CN, US) | (不筛选) |
limit |
限制返回的 IP 数量。 | 1 - 100000 | 1000 |
delimiter |
自定义多个 IP 地址之间的分隔符。 |
任意字符串。使用 \n 表示换行符。
|
\n (换行符) |
交互式 URL 生成器
点击“测试调用”以查看结果。
调用示例 (cURL)
# 获取出现次数最多的10个IPv4地址，以逗号分隔
curl "https://blackip.scdn.io/api/public.php?sort=ip_count_desc&ip_version=v4&limit=10&delimiter=,"
# 获取规则为 "Failed Host Command" 的所有IP地址 (一行一个)
curl "https://blackip.scdn.io/api/public.php?rule=Failed%20Host%20Command"