小胡的成长记录站——IP黑白名单系统

API调用教程

本系统提供了简单易用的API接口，方便开发者集成IP黑白名单查询功能。

接口列表

GET 获取所有IP记录

api.php?action=get_all

获取系统中所有的IP记录信息。

参数

参数名	类型	必填	描述
action	string	是	固定值：get_all

请求示例

curl "http://example.com/api.php?action=get_all"

响应示例

{"code":200,"message":"获取成功","data":[{"id":1,"ip":"192.168.1.0/24","location":"本地网络","isp":"","remark":"内部网络"},{"id":2,"ip":"10.0.0.1","location":"本地网络","isp":"","remark":"网关"}]}

GET 搜索IP记录

api.php?action=search&keyword=192.168

根据关键词搜索IP记录，可以搜索IP地址、网段、地区或备注信息。

参数

参数名	类型	必填	描述
action	string	是	固定值：search
keyword	string	是	搜索关键词

请求示例

curl "http://example.com/api.php?action=search&keyword=192.168"

响应示例

{"code":200,"message":"搜索成功","data":[{"id":1,"ip":"192.168.1.0/24","location":"本地网络","isp":"","remark":"内部网络"}]}

GET 默认接口（获取所有）

api.php

不提供任何参数时，默认返回所有IP记录。

请求示例

curl "http://example.com/api.php"

响应示例

{"code":200,"message":"获取成功","data":[{"id":1,"ip":"192.168.1.0/24","location":"本地网络","isp":"","remark":"内部网络"}]}

响应格式

所有API接口都返回JSON格式的数据，包含以下字段：

code：状态码（200表示成功，其他表示失败）
message：返回消息，描述操作结果
data：返回的数据，成功时包含IP记录列表，失败时为null

状态码说明

状态码	描述
200	请求成功
400	无效的请求操作
403	禁止修改操作

返回API页面