华为云开发者实践：用 API Explorer 核对 OBS 列举桶的签名差异

在华为云做联调时，对象存储 OBS 的列举桶（ListBuckets）经常是第一条探测请求：控制台能登录，不代表签名、endpoint 和凭证类型已经对齐。下面是我在 API Explorer 里把这次调用从“能点通”核对到“本地 SDK 可复现”的做法。

先固定三件事

1. endpoint：列举桶是账号级接口，使用对应区域的 OBS 服务域名，不要填成某个桶的自定义域名或 CDN 域名。
2. 凭证类型：API Explorer 里选择的鉴权要和线上一致。使用临时安全凭证时必须同时带上 security token，否则返回 403，现象和密钥抄错很像。
3. 时钟：签名时间与服务端相差过大会被直接拒绝。联调机器先做时间同步，再看业务错误码。

在 API Explorer 中的核对顺序

• 服务选择 OBS，接口选择列举桶，先发一版只含必填鉴权的请求，记录 HTTP 状态和 RequestId。
• 展开请求头，核对 Authorization、Date（或 x-obs-date），以及临时凭证场景下是否出现 x-obs-security-token。
• 用同一区域、同一凭证在本地 SDK 再发一次。两次 RequestId 不同是正常的，状态码和桶列表结构应一致。

常见偏差

小结

把 API Explorer 当作签名对照工具，而不是只当成试接口的按钮。先固定 endpoint、凭证类型和时钟，再比较 Explorer 与 SDK 的差异，列举桶这类入口会稳定很多。同一核对步骤可以写进团队联调清单，避免无意义地轮换密钥。