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 次)。

数据对象

对象字段
Toolslug、name、description、about、highlights[]、audience[]、faqs[]、url、icon、screenshot、category、tags[]、listedAt、featured、trending、pricing、views、score
Categoryslug、name、description、tags[]、weight、count(接口返回时附加)
ToolsStatstools、categories、tags

错误与限流

  • 找不到资源返回 404 与 JSON 错误体;参数非法返回 400。
  • /api/submit按 IP 限流:每小时 5 次,超限返回 429。
  • /api/sync需要带完整数据体,写入后立即生效并持久化到服务器快照。

订阅源

  • 站点 RSS:/feed.xml
  • 博客 RSS:/blog/feed.xml

RSS 源由 sitemap 与元数据基建自动生成;如需批量导出全量数据,请使用开放数据页的说明。

反馈