Postman & OpenAPI

Khả dụng

Đặc tả máy đọc được, luôn khớp với API đang chạy.

Đặc tả OpenAPI 3.1 được sinh trực tiếp từ mã nguồn đang chạy nên không bao giờ lệch với API thật.

curl https://creator.poroai.life/api/public/v1/openapi.json -o poro-openapi.json

Dùng trong Postman

  1. Postman → Import → Link → dán địa chỉ openapi.json ở trên.
  2. Tạo biến môi trường PORO_API_KEY.
  3. Thêm header X-Poro-Key: {{PORO_API_KEY}} ở cấp collection.

Sinh client

npx openapi-typescript https://creator.poroai.life/api/public/v1/openapi.json -o poro.d.ts
Nếu chỉ dùng JavaScript/TypeScript, nên dùng @poroai/sdk thay vì client sinh tự động — SDK đã lo idempotency, thử lại và chữ ký webhook.