kasushou-client

Kasushou 2.0 API 的 TypeScript SDK，采用 ESM 输出，使用 tsdown 打包，按领域组织模块。

特性

• ESM + TypeScript
• 按领域拆分：基础、商品、订单、后台、供货、回调
• 内置签名算法（sha1(timestamp + sortedJsonBody + apiKey)）
• 支持每个请求覆盖凭证（多租户场景）
• 回调验签工具（商品变更/订单回调/售后回调）

安装

npm i kasushou-client

使用

import { KasushouClient } from "kasushou-client";

const client = new KasushouClient({
  baseUrl: "https://your-domain.com",
  credentials: {
    userId: "用户接口APPID",
    apiKey: "用户apikey",
  },
  adminCredentials: {
    userId: "后台管理员账号",
    apiKey: "后台管理员apikey",
  },
  supplierCredentials: {
    userId: "供货商UserId",
    apiKey: "供货商apikey",
  },
});

const goods = await client.goods.list({ page: 1, limit: 20 });
console.log(goods.data.list);

目录结构

src/
  core/
    errors.ts
    http.ts
    signature.ts
    types.ts
  domains/
    shared.ts
    base/service.ts
    goods/service.ts
    orders/service.ts
    admin/service.ts
    supplier/service.ts
    callbacks/verifier.ts
  client.ts
  index.ts

接口映射

• 基础数据

• base.getUserInfo -> /api/v1/user/info

• 商品接口

• goods.listCategories -> /api/v1/goods/cate

• goods.list -> /api/v1/goods/list

• goods.getById -> /api/v1/goods/info

• goods.getPriceLogs -> /api/v1/goods/pricelog

• goods.getOrderAttachTemplate -> /api/v1/goods/attach

• 订单接口

• orders.create -> /api/v1/order/buy

• orders.query -> /api/v1/order/info

• orders.close -> /api/v1/order/close

• orders.complain -> /api/v1/order/complain

• 后台接口

• admin.listOrders -> /api/admin/v1/order/list

• admin.handleOrders -> /api/admin/v1/order/dual

• admin.adjustUserMoney -> /api/admin/v1/user/money

• admin.listComplaints -> /api/admin/v1/order/complainList

• admin.getComplaintInfo -> /api/admin/v1/order/complainInfo

• admin.handleComplaints -> /api/admin/v1/order/dualComplain

• 供货接口

• supplier.listOrders -> /api/mer/v1/order/orderList

• supplier.handleOrders -> /api/mer/v1/order/dualOrder

• supplier.listComplaints -> /api/mer/v1/orde/complainList

• supplier.getComplaintInfo -> /api/mer/v1/orde/complainInfo

• supplier.handleComplaints -> /api/mer/v1/orde/dualComplain

回调验签

const verifier = client.createCallbackVerifier("你的apikey");

const orderOk = verifier.verifyOrderNotify(orderPayload);
const complainOk = verifier.verifyComplainNotify(complainPayload);
const goodsOk = verifier.verifyGoodsChangeNotify(goodsPayload);

开发

npm install
npm run typecheck
npm run build