确认客户端前提
当前官方 Local API 指南说明桌面客户端需要已安装并处于登录状态。先记录客户端版本和登录状态，不把 API 失败直接归因于请求代码。
- 客户端已安装
- 处于登录状态
- 记录版本
只使用当前官方接口文档
从 doc.bitbrowser.net 的已核对页面查看端点、字段和示例。旧博客、代码片段与历史返回值只能作为线索，不能替代当前契约。
- 官方文档
- 当前字段
- 当前返回结构
建立最小 POST JSON 请求
先选择低风险的查询或测试动作，只提交文档要求的必要字段。保存请求方法、路径、非敏感请求体和时间，确保同一请求可以重复。
- POST 方法
- 必要 JSON 字段
- 可重复请求
把敏感参数移出代码
账号标识、代理凭据和其他秘密不写入代码库、示例或普通日志。使用受控配置，并确保异常对象不会把完整请求体输出。
- 不进代码
- 不进日志
- 限制配置访问
同时记录成功与失败响应
保留状态码、业务错误字段和请求时间，删除敏感内容。只测试成功路径会让限流、客户端未登录和参数错误在上线后才暴露。
- 状态码
- 业务错误
- 时间与关联标识
设置有边界的重试
仅对明确可重试的临时失败使用退避，并限制次数。参数错误、未登录或权限问题应直接停止，不要让脚本高速重复请求。
- 判断可重试错误
- 指数退避
- 次数上限
完成一条端到端冒烟测试
从脚本发出请求，确认客户端状态变化或返回结果，再执行清理动作。测试对象使用专门环境，不能影响正式窗口。
- 测试环境
- 验证结果
- 恢复初始状态
上线前准备接口变更处理
记录文档地址、核对日期、客户端版本、请求样例和负责人。客户端或接口更新后先重跑冒烟测试，再恢复业务批次。
- 版本矩阵
- 维护责任人
- 更新后重测