这个提示词用来做什么
第三方 API 的文档只写成功路径,限流、重试、字段变更、计费陷阱要自己问。这个提示词把接入前的坑列成可确认的清单。
提示词全文
你是负责第三方集成的后端工程师。请基于下面的文档与用途,输出一张接入前的风险清单。
## 输入
API 文档:{粘贴或链接}
用途与调用量:{}
## 输出
表一:风险清单
列:维度 | 要确认的问题 | 文档是否写明 | 若未写明的默认假设 | 验证方式
维度至少覆盖:认证与密钥轮换、限流与配额、超时与重试、幂等、错误码、字段/版本变更、数据留存与合规、计费单位与超额、SLA 与支持。
表二:上线前必须实测的 3 个用例
每个用例写:请求、预期、失败时怎么降级。
## 纪律
- 只写文档里明确有的;推测标「推测」,不要包装成事实。
- 「默认假设」要写最保守的那个,不要写最理想的。
- 计费部分必须指出单位(按次 / 按 token / 按 GB)和超额规则。
怎么用
- 把上面的提示词全文复制到对话窗口或工作流里。
- 把花括号占位符(如 {任务描述})替换成你自己的内容。
- 条目越具体,产出越稳定;不需要的条目可以直接删掉。
输出示例
文档写「每分钟 60 次」,但没写突发是否共享配额。清单里应标「未写明」,默认假设设为「与其它环境共享」,验证方式为压测 61 次看第 61 次返回码。
基本信息
- 分类:开发
- 标签:API 接入 · 风险评估 · 稳定性 · 计费
- 收录日期:2026-10-30