对接第三方 API：先核实真实响应，别照着文档猜字段

接第三方 API 时，文档写的字段名/结构可能和实际返回不一致，或版本已经变了。先发一个真实请求把响应打出来看，再按真实结构写解析。

适用场景

解决思路

1. 第一步永远是发一个最小真实请求（curl 或 SDK 示例），把完整响应体打出来看
2. 核对真实字段名/嵌套结构/类型，别照文档猜——文档常滞后于实际 API
3. 确认认证方式生效：先打最基础的只读端点（如 /models、/me），别一上来用业务端点判死活
4. 错误码要读响应体的原文 message：403 通常是权限/白名单问题而非凭据失效，401 才是凭据问题
5. 限流是自己打出来的：连打多个请求要加间隔，否则会误判成「凭据无效」
6. 把真实响应存下来当测试夹具，别用自己臆想的假数据当依据

适用边界 · 注意事项

• ❌ 别照文档写解析代码再线上跑（字段名/结构不一致会静默拿到 undefined）
• ❌ 别用业务端点的失败当「凭据失效」的证据（混合了权限/额度/限流等因素）
• 别用臆想的 mock 数据做验证 —— 会形成自证循环，验证不出真实契约问题