# 白洞门店云开放接口 JavaScript SDK 变更记录

## 0.2.0 - 2026-05-24

- 新增 `SDK_VERSION`，便于外部系统记录接入版本。
- 新增 `OPEN_API_ERROR_CODES`，覆盖签名失败、套餐未开通开放接口、开放接口额度超限和资源模块未开通。
- 新增 `buildPageQuery`，统一列表分页参数，并将 `pageSize` 限制在 100 以内。
- 新增 `retry`、`retryDelayMs`、`retryOnStatusCodes` 配置，默认支持对 429 和 5xx 状态重试。
- 补齐当前十二类开放接口资源方法。
- 新增 TypeScript 类型声明文件 `whitehole-open-api-sdk.d.ts`。

## 0.1.0 - 2026-05-24

- 提供 `WhiteholeOpenApiClient`、`signOpenApiRequest` 和 `requestOpenApi`。
- 封装 `X-WH-App-Key`、`X-WH-Timestamp`、`X-WH-Signature` 请求头生成。
- 请求带查询参数时，签名只使用路径部分，与开放接口服务端校验规则一致。