Public API
API 文档
用同一套目录数据构建你自己的工具：REST API、静态快照与 RSS 订阅。
概览
Base URL 为站点域名（https://dsh-ai.org），所有接口返回 JSON， 无需鉴权。列表与详情接口带 cache-control: public, max-age=60, stale-while-revalidate=300。 错误统一为 { "error": { "code", "message" } }。
GET /api/plugins
分页列出已发布插件，支持关键词、分类与排序。
| 参数 | 类型 / 默认 | 说明 |
|---|---|---|
| q | string · — | 关键词，匹配名称 / 作者 / 中英描述 |
| category | string · — | 分类 id，如 memory、security |
| sort | popular | downloads | stars | newest | updated · popular | 排序方式 |
| page | int ≥1 · 1 | 页码 |
| limit | int 1–100 · 24 | 每页条数 |
curlshell
curl 'https://dsh-ai.org/api/plugins?q=memory&sort=stars&limit=5'响应为 { data: [...], meta: { total, pages, categories, ... } }， 每个插件包含 slug / description.en·zh / install.command / signals.stars / signals.downloads30d 等字段。
GET /api/plugins/{'{slug}'}
按 slug（形如 owner/name，含斜杠）读取单个插件详情， 额外返回版本历史 versions[] 与扫描证据 evidence[]。
curlshell
curl 'https://dsh-ai.org/api/plugins/vectorize-io/hindsight-coding-agents'GET /api/health
服务与数据库健康检查，返回已收录插件数与延迟；数据库异常时返回 503。
curlshell
curl 'https://dsh-ai.org/api/health'静态数据源
/plugins.json 是完整目录快照（含分类双语标签），适合一次性拉取；/rss.xml 是最新收录 50 个插件的 RSS 2.0 订阅。
curlshell
curl 'https://dsh-ai.org/plugins.json' | jq '.count, .plugins[0].name'即将上线
语义搜索 GET /api/search?mode=semantic、 相关推荐 GET /api/plugins/{slug}/related、 遥测上报 POST /api/telemetry/events 与出站 Webhook 订阅正在开发中， 契约以仓库内 docs/api.md 为准。