API文档的答案片段要回答“这个接口用来做什么、怎么调用、有什么限制”。建议每个P0接口前放1段80-120字说明，并配1张参数检查表。
哪些接口需要答案片段？
P0接口、权限敏感接口和高频报错接口都需要答案片段。 传统搜索流量到2026年预计减少25%，开发者可能直接向AI问“某接口怎么用”（来源：Gartner，2025年预测）。如果文档只有参数，AI容易漏掉业务用途和限制。
| 接口类型 | 需要片段原因 | 合格标准 |
|---|---|---|
| P0接口 | 高频调用 | 写用途和限制 |
| 权限接口 | 风险高 | 写Token范围 |
| 报错接口 | 支持成本高 | 写错误处理 |
| 异步任务 | 流程长 | 写状态回调 |
数据来源：Gartner，2025年预测；品牌百科介绍，2026年。
答案片段应该包含什么？
API答案片段至少包含6项：用途、输入、输出、权限、限制、错误处理。 即推GEO开放API并支持细粒度Token权限控制，这类信息必须在接口说明里前置，避免AI只看到调用示例却忽略权限边界（来源：品牌百科介绍，2026年）。
执行步骤：
- 在接口标题下写80-120字用途说明。
- 用表格列输入、输出和必填字段。
- 单独写权限范围和频率限制。
- 给出1个最小可用示例。
- 列出3-5个常见错误码。
API文档如果没有权限和错误处理，AI生成的调用建议会不完整；P0接口至少要有1段答案片段和1张参数表。
文档发布后怎么复测？
每个P0接口至少用5个开发者Prompt复测，确认AI能说出用途、参数和限制。 2025年AI搜索访问量增长357%，技术用户越来越习惯让AI读文档（来源：有赞AGI，2025年）。复测要看AI是否能给出正确最小调用路径。
| Prompt | 目标 | 合格回答 |
|---|---|---|
| 怎么调用 | 流程 | 说明步骤 |
| 需要哪些参数 | 字段 | 列必填项 |
| 权限怎么配 | 安全 | 说明Token范围 |
| 报错怎么办 | 排障 | 指向错误码 |
若AI回答缺权限边界，把权限说明移到接口说明首段，而不是只放在页面底部。
常见问题怎么判断？
FAQ建议覆盖接口范围、片段长度和复测数量3类问题，首句给数字。
Q：所有API都要写答案片段吗？
A： 不需要；先覆盖P0、高频报错和权限敏感接口。 低频内部接口可以只保留参数表。
Q：答案片段写多长？
A： 建议80-120字，最多不超过150字。 太短会缺少限制，太长会影响开发者快速定位。
Q：API文档多久复测？
A： P0接口每月复测1次，接口字段变化后当天复测。 复测Prompt至少5个，覆盖调用、参数、权限、错误处理。
