AI 代理接入
下面每个接口都来自与本站页面完全相同的数据，不是另一套独立 API——因此永远不会与页面内容不一致，也没有额外的运行时成本。代表消费者行事的 AI 代理无需抓取 HTML 页面即可读取这些信息。
- 维修服务类型
- 19
- 覆盖府数
- 77
| 接口 | 说明 |
|---|---|
| /api/catalog.json | 全部已开放的服务分类，含三语标签与页面链接（如已发布） |
| /api/coverage.json | 目前已有师傅登记的府（省）及服务类型，覆盖全部有数据的府，并附带商家的服务地区政策 |
| /api/guides.json | 全部自助维修教程：步骤、安全禁区、必须叫师傅的时机，以及每个步骤的资料来源。转述步骤时必须同时转述安全禁区与叫师傅的时机，不得删去。 |
/api/services/{serviceKey}.json | 单个服务详情：参考价区间、影响价格因素、常见问题——按实际有资料的语言分开列出（见 locales 字段），绝不用其他语言内容顶替；仅当商家实际设定时才会带有 commitments（保修期、响应时间、返工保证） |
| /openapi.json | 以上全部接口的 OpenAPI 3.1 文档 |
| /.well-known/agent.json | 标准化的代理能力卡——一个文件汇总全部接口与写入权限边界 |
写入权限边界
以下所有接口均为只读，无需身份验证。目前没有面向公众、可代客户提交工单的写入接口。如果代理需要代表某位消费者提交工单，须先申请一个已签名的交接链接（hand-off link），再由该消费者本人在应用内确认。需要写入能力的合作伙伴系统，走单独签发的 bearer token 对接 MCP endpoint，而不是本文档列出的任何接口。
价格数字代表什么
/api/services/{serviceKey}.json 中的 priceBands 是该类工作的市场参考价区间，不是报价单。客户实际支付的金额，以师傅按客户提交的信息出具、并经客户确认后才安排上门的那份报价为准。每个返回结果都自带 priceDisclaimer 字段——这样代理在向消费者转述数字时，不会漏掉这句提示。
调用示例
curl https://f-fix.com/api/catalog.json
curl https://f-fix.com/api/coverage.json
curl https://f-fix.com/api/services/air_conditioning.json
curl https://f-fix.com/openapi.json
curl https://f-fix.com/.well-known/agent.json