KONG API AI Tài liệu Bắt đầu miễn phí

Nhà phát triển

Mã lỗi

Bảng mã lỗi của API KONG API AI: số trạng thái, mã lỗi, ý nghĩa và cách xử lý cho từng trường hợp.

Dạng của một lỗi

Mọi lỗi trả về JSON có cùng dạng:

JSON
{"error": {"code": "key_limit", "message": "…"}}

Hãy xử lý theo code. Phần message dành cho người đọc và có thể đổi.

Bảng mã lỗi

SốMãÝ nghĩa và cách xử lý
400invalid_jsonNội dung gửi lên không phải JSON hợp lệ.
400model_requiredThiếu trường model.
400unknown_modelModel không có trong danh mục. Xem Model và giá.
401unauthorizedThiếu khoá hoặc khoá không hợp lệ.
402key_limitKhoá đã chạm hạn mức tháng. Tăng hạn mức hoặc chờ đầu tháng.
402budget_exceededMột hạn mức của thành viên, khách hàng hoặc không gian làm việc đã hết.
402insufficient_budgetSố dư khả dụng không đủ để giữ trước chi phí tối đa của yêu cầu. Nạp thêm số dư.
403key_paused, key_revokedKhoá đang tạm dừng hoặc đã bị thu hồi.
403model_forbiddenModel nằm ngoài các model khoá được dùng.
403application_disabled, customer_disabledỨng dụng hoặc khách hàng đang bị tắt.
404not_foundĐịa chỉ không được hỗ trợ, hoặc không tìm thấy yêu cầu.
409duplicate_requestYêu cầu với Idempotency-Key này đã được nhận. Đọc trạng thái ở /v1/requests/{id}.
409idempotency_conflictCùng Idempotency-Key nhưng nội dung khác. Dùng mã mới.
413body_too_largeNội dung vượt 2 MB.
429own_quota_unavailableKhông nguồn riêng nào xử lý được và dự phòng bằng số dư đang tắt.
429tenant_rate_limitGửi quá nhiều yêu cầu. Thử lại sau thời gian ghi trong header Retry-After.
503workspace_pausedQuản trị viên đã tạm dừng mọi khoá.
503queue_timeoutKhông có nguồn phù hợp trong thời gian chờ. Thử lại sau.
503gateway_overloaded, drainingHệ thống đang đầy hoặc đang cập nhật. Thử lại sau vài giây.

Nên thử lại lỗi nào

  • Thử lại được: 429 và 503. Chờ theo Retry-After nếu có, và giữ nguyên Idempotency-Key để không bị tính hai lần.
  • Không thử lại: 400, 401, 403, 413. Phải sửa yêu cầu hoặc khoá.
  • Cần người xử lý: 402. Tăng hạn mức hoặc nạp số dư.

Yêu cầu lỗi có bị tính tiền không

Không. Yêu cầu lỗi không bị trừ số dư. Nếu chưa rõ kết quả, khoản tiền được giữ lại cho tới khi đối soát xong, rồi được trừ hoặc trả lại.