API 与数据接口
全站数据的只读接口与同步通道,无需鉴权,返回 JSON。
快速开始
所有端点都是标准 REST GET/POST,返回 JSON。把示例中的域名替换为你的部署域名即可直接调用,只返回有效收录。
curl "https://你的域名/api/tools?limit=5"
curl "https://你的域名/api/tools?q=AI&limit=5"
curl "https://你的域名/api/tools/<slug>"
curl "https://你的域名/api/categories"端点
GET/api/tools
搜索或列出工具,支持分页与排序。
查询参数:q、category、featured、trending、tag、sort(newest / popular / name)、limit、offset
GET/api/tools/{slug}
获取单个工具详情,含 about、highlights、audience、faqs 与相关推荐。
GET/api/categories
列出全部分类,含每个分类的工具计数。
POST/api/sync
数据同步入口:批量写入工具与分类,merge / replace 双模式,用于服务器一键采集。
POST/api/submit
前台提交收录:校验后合并进目录并落盘,带 IP 频率限制(每小时 5 次)。
数据对象
| 对象 | 字段 |
|---|---|
| Tool | slug、name、description、about、highlights[]、audience[]、faqs[]、url、icon、screenshot、category、tags[]、listedAt、featured、trending、pricing、views、score |
| Category | slug、name、description、tags[]、weight、count(接口返回时附加) |
| ToolsStats | tools、categories、tags |
错误与限流
- 找不到资源返回 404 与 JSON 错误体;参数非法返回 400。
/api/submit按 IP 限流:每小时 5 次,超限返回 429。/api/sync需要带完整数据体,写入后立即生效并持久化到服务器快照。
订阅源
- 站点 RSS:
/feed.xml - 博客 RSS:
/blog/feed.xml
RSS 源由 sitemap 与元数据基建自动生成;如需批量导出全量数据,请使用开放数据页的说明。