所有接口均为 GET，匿名调用，返回 application/json，且不写入任何数据。第一条命令就能拿到站点统计：
建议第一个请求先调 /api/v1/meta，从中取得合法的分区 key、站点值与分页上限，避免参数报错。
本页 12 个接口已封装为 Python MCP 包 800bus-mcp，可在 Claude Desktop、Cursor 等支持 MCP 的客户端中直接调用。全部工具只读、无副作用，不写入数据也不发通知。
客户端配置（stdio 传输）：
安装后可用 800bus-mcp --selftest 检查连通性；返回结构与本页接口一致（success / data / meta），同样受 60 次/分钟/IP 限流约束。源码与配置示例见 PyPI 项目页。
成功：{"success": true, "data": ..., "meta": {...}} 失败：{"success": false, "error": {"code": "...", "message": "..."}}
列表接口的 meta 固定包含 page、limit、total、total_pages；时间字段统一为 ISO 8601（含时区）。
错误码：bad_request(400)、not_found(404)、rate_limited(429)、server_error(500)。
| 路径 | 说明 | 主要参数 |
|---|---|---|
| /api/v1/stats | 站点统计 | — |
| /api/v1/meta | 分区 / 站点 / 排序字典 | — |
| /api/v1/photos | 档案搜索与分页列表 | q、plate、section、site、region、company_id、author_id、featured、sort、page、limit |
| /api/v1/photos/{id} | 档案详情（含作者公开资料、评论数） | id |
| /api/v1/photos/{id}/comments | 档案评论（匿名评论已遮蔽） | id、page、limit |
| /api/v1/news | 资讯列表 | category、province_id、city_id、page、limit |
| /api/v1/news/{id} | 资讯详情（仅已发布） | id |
| /api/v1/regions | 省 / 市 / 公司层级 | level=province|city|company、parent_id |
| /api/v1/companies/{id} | 公司详情 + 旗下档案 | id、page、limit |
| /api/v1/users/{id} | 用户公开资料（不含邮箱） | id |
| /api/v1/rankings | 周榜（档案）/ 月榜（贡献者） | type=weekly|monthly、limit |
| /api/v1/map/markers | 地图标记 | bbox 或 sw_lat/sw_lng/ne_lat/ne_lng、section、limit |
默认 60 次 / 分钟 / IP，响应头返回 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset。超限返回 429，并带 Retry-After（秒）。
50 条，地图标记单次最大 500 个Cache-Control，请尊重缓存头，避免重复拉取thumbnail 而非 photo.original，原图仅用于详情展示如需商业授权或更大调用额度，请通过开放平台页面提供的联系方式沟通。
下方为交互式文档，可直接点开任一接口并「Try it out」。加载失败时可直接查看 /openapi.json。