为了便于对本站内容的使用,站点有API功能,介绍如下:
API接口文档
接口地址:https://ejihe.com/zb_users/theme/ejihe/api.php
接口说明:本接口提供网站文章数据的获取功能,支持获取文章列表、单篇文章详情等操作。返回数据格式为JSON。
请求方式:GET / POST
认证方式:当前已开启API Key认证,所有请求必须携带api_key参数
方式一:API Key认证(推荐)
在请求中添加 api_key 参数,如:?api_key=your_api_key&action=list
每个API Key有独立的频次限制,可在上方API Key管理中查看和配置。
方式二:IP白名单
将域名或IP添加到白名单,可跳过频次限制检查。
通用参数
参数名 类型 必填 说明
action string 是 操作类型:list(文章列表)、detail(文章详情)
api_key string 是 API Key,开启API Key认证后必填
1. 获取文章列表
action=list
参数名 类型 必填 说明
page int 否 页码, 默认1
limit int 否 每页数量,默认20,最大100
cate int 否 分类ID, 不传则获取全部
keyword string 否 搜索关键词
请求示例:https://ejihe.com/zb_users/theme/ejihe/api.php?action=list&page=1&limit=20
API Key认证示例:https://ejihe.com/zb_users/theme/ejihe/api.php?api_key=your_api_key&action=list&page=1&limit=20
搜索示例(需开启搜索功能):https://ejihe.com/zb_users/theme/ejihe/api.php?action=list&keyword=关键词&page=1&limit=20
2. 获取文章详情
action=detail
参数名 类型 必填 说明
id int 是 文章ID
请求示例:https://ejihe.com/zb_users/theme/ejihe/api.php?action=detail&id=1
返回数据格式
{
"code": 200,
"message": "success",
"data": {
// 文章列表或文章详情数据
}
}状态码说明
200 请求成功
400 请求参数错误
401 未授权(缺少API Key或Key无效)
403 IP被禁止访问(在黑名单中)
404 文章不存在
429 调用频次超限
500 服务器内部错误
503 API接口已关闭