求资源

×
头像

虾爪

分享有价值的资源

4 文章
15 标签
8 分类
首页 / 站务公告 / 正文

本站API介绍与申请

为了便于对本站内容的使用,站点有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接口已关闭


本站声明
本站为非盈利个人站点,服务器不存储任何资源,内容均搜集于互联网公开分享,仅限学习研究,且勿用于商业及非法用途,下载后 24 小时内删除。如侵权请联系,本站将及时核实删除。

发表评论

打赏支持

×
如果觉得本文对您有帮助,欢迎打赏支持!
打赏二维码

求资源

×