中文精选提示词 · 一键复制 · 陪你用好 AI

✍ 搭子陪写
Vibe Coding提示词AI进阶★ 搭子精选

第三方 API 对接联调问题排查手册生成器

对接外部接口联调受阻时,生成一份从网络层到业务层的分层排查手册与证据收集清单,快速定位是我方还是对方的问题。

★★★★★ 搭子评分 · 难度 进阶 · 作者 提示词搭子(AI 生成) · 协议 CC-BY 4.0
人工精选 · 一键复制即用
适用场景:对接支付、短信、物流等第三方接口时联调报错、回调收不到,需要快速分清是我方问题还是对方问题。
提示词内容
你是一名有丰富外部系统对接经验的后端工程师。我正在与第三方服务做接口联调并遇到问题,请为我生成一份结构化的排查手册。

我提供的背景:
- 第三方服务类型:{支付、短信、地图、物流、身份核验、云存储、自定义}
- 我方技术栈与调用方式:{语言框架、HTTP 客户端、是否经过网关或代理}
- 当前现象:{例如超时、证书错误、签名校验失败、回调收不到、偶发五百、字段缺失}
- 环境:{本地 / 测试 / 预发 / 生产}
- 已经尝试过的手段:{填写,没有可写“暂无”}

请按以下七个层次输出排查手册,每一层都要给出具体的验证命令或代码片段、预期结果、以及该结果分别指向什么结论:
第一层是网络连通性,覆盖域名解析、出口地址是否在对方白名单、端口是否放通、是否被公司代理拦截、是否存在跨地域访问问题。
第二层是传输安全,覆盖证书链是否完整、协议版本是否被对方限制、系统时间偏差是否导致签名过期、是否需要双向认证。
第三层是请求构造,覆盖请求方法、内容类型、字符编码、参数排序规则、空值参与签名与否、时间戳格式、随机串是否复用。
第四层是鉴权与签名,给出一套可复现的自查流程,包括如何用对方文档中的示例数据反向验证我方签名算法是否正确,这一步能最快分清是算法错还是密钥错。
第五层是幂等与重试,说明哪些错误码可以重试、哪些绝对不能重试、重试的退避策略如何设定、如何避免重复扣款或重复发货。
第六层是回调接收,覆盖回调地址是否可被公网访问、是否被安全组或防火墙拦截、验签是否正确、响应体格式是否符合对方要求、处理耗时是否超过对方等待阈值导致重复回调。
第七层是业务语义,覆盖字段含义理解偏差、金额单位是元还是分、时区差异、枚举值取值范围、分页规则。

完成分层排查后,请再输出三部分内容:
一、证据收集清单。列出在联系第三方技术支持之前必须准备好的十项材料,例如完整请求响应报文、请求唯一标识、精确到毫秒的时间点、我方出口地址、复现步骤、抓包文件。
二、对外沟通模板。写一份发给第三方技术支持的问题描述模板,要求事实与结论分离,先给现象与证据,再给我方的初步判断,避免直接指责对方系统故障。
三、长期防护建议。给出六条工程实践建议,覆盖接口调用日志留痕、超时与熔断配置、沙箱与生产配置隔离、密钥轮换、对方变更公告的订阅机制、以及关键链路的兜底方案。

输出要求:所有命令与代码需可直接复制执行;涉及密钥、令牌与商户号的位置一律使用占位符,禁止在输出中包含任何真实凭据;无法确定的第三方规则请明确标注为需查阅对方文档确认,不要凭印象作答。

来源:本站 AI 原生生成内容(原创,遵循 CC-BY 4.0,可自由使用并注明出处)。