@qzsy/kuaishou-sdk

快手小店开放平台的 Bun + TypeScript SDK。内置 346 个 API 的请求和响应类型，包含完整的接口字段、嵌套结构和逐接口文档。

安装

bun add @qzsy/kuaishou-sdk

使用

import { createKuaishouClient } from "@qzsy/kuaishou-sdk";

const client = createKuaishouClient({
  appKey: process.env.KUAISHOU_APP_KEY!,
  signSecret: process.env.KUAISHOU_SIGN_SECRET!,
  accessToken: process.env.KUAISHOU_ACCESS_TOKEN!
});

const response = await client.api.openItemAutopassEdit({
  itemId: 3221412313,
  purchaseLimit: true,
  limitCount: 99
});

console.log(response);

SDK 默认使用 HMAC_SHA256，也可以设置 signMethod: "MD5"。访问令牌申请与刷新由使用方根据开放平台 OAuth 流程处理。可注入兼容 Fetch 的 fetch 函数以适配自定义网络环境。

业务返回码不是成功（result !== 1，或网关 code / sub_code 表示失败）时，请求会抛出 KuaishouApiError。错误对象带有 result、code、subCode、官方说明 info 和原始 response。码表来自开放平台《返回码说明》，可用 KuaishouResultCode 与 explainKuaishouCode 对照。需要自己判断原始 JSON 时，创建客户端传入 throwOnError: false。

构建

在 monorepo 根目录运行 bun install 后执行 bun run build。npm 包的 ESM 入口、类型入口和 exports 均统一指向 dist；发布包仅包含 dist 与本 README。

文档

• 346 个 API 的 URL 索引
• 调用与签名说明