Bộ SDK

npm install @poroai/sdk

import { PoroClient, PoroError } from "@poroai/sdk";

const poro = new PoroClient({ apiKey: process.env.PORO_API_KEY! });

const { data: pools } = await poro.inventory.list({ storeId });

const reservation = await poro.inventory.reserve(
  { poolId: pools[0].id, quantity: 2, ttlSeconds: 600 },
  "order-8891",
);

await poro.orders.create({
  storeId,
  customerName: "Nguyễn An",
  items: [{ poolId: pools[0].id, quantity: 2, reservationId: reservation.id }],
});

SDK lo giúp bạn

• Tự sinh Idempotency-Key cho mọi lệnh ghi.
• Tự thử lại lỗi 429/5xx với backoff mũ, timeout mặc định 15 giây.
• Lỗi có kiểu: PoroError kèm type, code, param, requestId, retryable.
• Xác minh chữ ký webhook bằng poro.webhooks.constructEvent().
• Chạy được trên Node 18+, Bun, Deno, Cloudflare Workers.