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.jsonDùng trong Postman
- Postman → Import → Link → dán địa chỉ openapi.json ở trên.
- Tạo biến môi trường PORO_API_KEY.
- 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.tsNế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.