接口调试：按请求、响应和超时顺序排查

接口调试时，不要一看到报错就改代码。先判断问题出在哪一段：请求是否发出、服务端是否响应、返回内容能否被程序处理。记录发生时间、请求路径、状态码和脱敏后的错误信息；密钥、个人资料及完整敏感内容不要写入日志。 如果请求没有发出或立即报错，先检查本机网络、目标地址、请求方法和必要参数，再确认密钥是否从服务端或受保护的本机配置读取。不要把密钥放进网页代码、文章或日

接口调试时，不要一看到报错就改代码。先判断问题出在哪一段：请求是否发出、服务端是否响应、返回内容能否被程序处理。记录发生时间、请求路径、状态码和脱敏后的错误信息；密钥、个人资料及完整敏感内容不要写入日志。

如果请求没有发出或立即报错，先检查本机网络、目标地址、请求方法和必要参数，再确认密钥是否从服务端或受保护的本机配置读取。不要把密钥放进网页代码、文章或日志。如果问题只在某个输入下出现，可用不含敏感信息的最小请求复现，再逐项核对字段名称、数据格式和必填内容。不同服务的参数规则可能不同，不要直接套用。

收到响应后，先查看状态码和错误正文，再判断是否与认证、参数、权限或服务端处理有关。状态码只能提供线索，需结合接口说明和响应内容判断。请求成功也不代表结果符合预期：检查返回结构是否完整、程序读取的字段是否存在，并对照输入检查模型输出。模型输出不等于事实核验，涉及事实时应另行查证。

如果等待超时，不要据此认定请求没有处理或没有计费。先核对是否已有响应、任务记录或可查询结果；如果有任务编号，可用它定位原请求。对于自有系统，可保存任务编号和内容摘要，在入库前检查任务是否已处理，以减少重复写入。没有可用记录时，再评估是否重试，并考虑重复执行可能带来的影响。

排查结束后，记录复现条件、发现的问题和修复结果。如果问题涉及服务端状态、权限或无法查看的处理记录，整理请求时间、错误信息和任务编号，向接口提供方核实。接口的字段、状态和查询能力各不相同，具体操作应以对应文档和实际返回为准。