APPBK DATA SERVICE
App 市场数据 REST / MCP 服务
只读查询 MySQL 中已经采集的数据，不会实时请求 RapidAPI，也不会启动爬虫。
认证
除健康检查和文档外，REST 与 MCP 接口均需 Bearer Token。
Authorization: Bearer <APPBK_API_KEY>
REST 接口
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /healthz | 服务健康检查（无需 Token） |
| GET | /api/v1/rankings | 最新总榜或分类榜 |
| GET | /api/v1/categories | 分类目录 |
| GET | /api/v1/category-rankings | 按分类名或 ID 查询榜单 |
| GET | /api/v1/apps/search | 搜索 App、开发者或 Apple ID |
| GET | /api/v1/apps/{app} | App 基础或完整详情 |
| GET | /api/v1/apps/{app}/reviews | 已采集评论 |
| GET | /api/v1/apps/{app}/review-signals | 评分和评论信号 |
| GET | /api/v1/apps/{app}/rank-history | 榜单排名历史 |
| GET | /api/v1/market-changes | 最新两次榜单变化 |
调用示例
curl -H "Authorization: Bearer $APPBK_MCP_API_KEY" \ "https://your-domain.example/api/v1/rankings?country=cn&collection=topfreeapplications&category=all&limit=10"
MCP
POST /mcp 使用 Streamable HTTP，可供 Codex、Claude Code 等 MCP 客户端连接。
接口的完整参数与约束以 OpenAPI 文档为准。