Bắt đầu nhanh

Khả dụng

Từ không có gì đến lệnh gọi API đầu tiên trong khoảng 10 phút.

  1. Tạo tài khoản developer và đăng nhập vào Console.
  2. Chọn tổ chức (mỗi khoá API thuộc đúng một tổ chức).
  3. Tạo khoá API trong Console → API & khoá truy cập. Khoá chỉ hiện đầy đủ một lần.
  4. Gọi thử bằng cURL hoặc API Explorer.
  5. Xem lượt gọi và độ trễ trong phần đo mức sử dụng.

Lệnh gọi đầu tiên

curl -X POST https://creator.poroai.life/api/public/v1/gateway \
  -H "Content-Type: application/json" \
  -H "X-Poro-Key: poro_<prefix>_<secret>" \
  -d '{
    "operation": "inventory.list",
    "storeId": "<store_id>"
  }'

Phản hồi

{
  "ok": true,
  "requestId": "req_01J...",
  "operation": "inventory.list",
  "connector": "core-inventory",
  "tenant": "org_01J...",
  "latencyMs": 42,
  "replayed": false,
  "data": [ { "sku": "SKU-001", "available": 501, "reserved": 3 } ]
}
Mọi lệnh ghi nên kèm idempotencyKey. Gọi lại cùng khoá sẽ trả lại kết quả cũ với replayed = true thay vì tạo trùng.