首页 › 关于 › 目录 API

目录 API v1

只读、无鉴权。这是对外契约：改字段名或删字段要升 v2。不是 WordPress.org API，也不是带查询参数的 REST。

根地址

生产根是 https://wpbridge.com/api/v1。本地预览走 /api/v1/。信封字段 api、version、kind、asof、data。

GET https://wpbridge.com/api/v1/info.json
GET https://wpbridge.com/api/v1/schema.json
GET https://wpbridge.com/api/v1/categories.json
GET https://wpbridge.com/api/v1/hosts.json
GET https://wpbridge.com/api/v1/tags.json
GET https://wpbridge.com/api/v1/plugins.json
GET https://wpbridge.com/api/v1/themes.json
GET https://wpbridge.com/api/v1/items/{host}/{owner}/{repo}.json
GET https://wpbridge.com/api/v1/blueprints/{host}/{owner}/{repo}.json

• id 为 host/owner/repo。GitLab 分组仓库可以有多段。
• kind=theme 是 WordPress 主题包。kind=plugin 且 category=themes 是主题辅助插件。
• 列表是短字段；items/… 含作者、许可证、topics。没有的字段就不写。
• blueprints/ 是 WordPress Playground 原样 JSON，没有信封。只给作者 zip；GitHub 源码包不写蓝图。
• 条目上的 playground：intl 始终有，cn 只在 zip 国内能拉到时出现。试用链接走 hash 蓝图，不靠跨域拉 JSON。
• 契约正文在仓里 api/v1/README.md 与 schema.json。

CLI

和 API 同一套字段。本机有仓库数据时读 data/，否则读上面的生产根。

python3 -m wpbridge info
python3 -m wpbridge search "git updater"
python3 -m wpbridge show github/afragen/git-updater
python3 -m wpbridge list --kind theme --limit 10
python3 -m wpbridge search "sage" --json
python3 -m wpbridge try github/solstice23/argon-theme
python3 -m wpbridge blueprint github/solstice23/argon-theme

内部索引

站点页面仍读 /data/*.min.json。那是采集脚本的工作文件，不是 v1 契约，字段可能随周变更。