Skip to content

Mã lỗi ​

Trang sinh tự động

Nguồn: code/apps/api/supabase/functions/_shared/errors.ts. Không sửa tay.

Client chỉ rẽ nhánh theo extensions.code, không parse message. Đây là toàn bộ danh sách mã; lỗi không mang mã nào trong số này ra khỏi server dưới dạng internal với message cố định — không rò message gốc, SQL, stack hay secret.

Edge Function không phải GraphQL dùng cùng bộ mã trong { error: { code, message, details } }.

extensions.codeHTTPMessage mặc định
unauthorized401Chưa đăng nhập.
forbidden403Không có quyền thực hiện thao tác này.
not_found404
validation_failed422
conflict409
internal500
otp_invalid422
too_many_requests429
stale_version409
policy_undecided409
provider_unknown502

11 mã. Ba mã conflict, stale_version, policy_undecided dùng cùng HTTP 409 nhưng khác nhau về ý nghĩa, nên client phải đọc code chứ không đọc status.

Dùng mã nào khi nào ​

Phần này mô tả quy ước, nguồn là docs/contracts/api-conventions.md §2:

  • validation_failed mang details theo flatten() của Zod (formErrors, fieldErrors), cộng reason và field khi có.
  • conflict mang details.reason, ví dụ idempotency_key_reuse khi dùng lại requestId với payload khác.
  • stale_version mang expectedVersion và actualVersion.
  • provider_unknown nghĩa là nhà cung cấp chưa trả lời dứt khoát — client phải hỏi lại trạng thái hoặc thử lại với cùng requestId, không được coi là thất bại rồi tạo thanh toán mới.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17