Tham khảo & Khắc phục sự cố

Mã lỗi và Khắc phục sự cố

View as Markdown

Định dạng phản hồi lỗi

1{
2  "code": 1003,
3  "message": "Invalid token",
4  "requestId": "req-12345678"
5}

Lỗi kinh doanh thường vẫn trả về cấu trúc JSON thống nhất. Các chuyên gia tích hợp nên kiểm tra code trước. Lỗi xác thực có thể trả về HTTP 401; Giới hạn tốc độ có thể trả HTTP 429.

Các Mã Lỗi Phổ Biến

Mã lỗiMô tả
0Thành công
1001Không cung cấp thông tin xác thực hợp lệ
1002Token đã hết hạn
1003Mã token, API Keyhoặc chữ ký không hợp lệ
1004Token bị thu hồi
1006Nguồn IP sự không khớp
2001Thiếu tham số bắt buộc
2002Giá trị tham số không hợp lệ
2003Tham số nằm ngoài phạm vi
3001Cân bằng không đủ
3003Không tìm thấy đơn hàng
3004Yêu cầu trùng lặp
3005Đơn hàng không thể hủy
3006Xin phép bị từ chối
3100 - 3112Lỗi xác thực tham số thứ tự điều kiện
5001Lỗi máy chủ nội bộ
5002Dịch vụ tạm thời không khả dụng
5003Giới hạn tốc độ được kích hoạt

Khắc phục sự cố

Vấn đềKhuyến nghị
1001 không có thông tin xác thực hợp lệKiểm tra xem Authorization: Bearer <accessToken> hay X-API-KEY có bao gồm không.
1002 Token đã hết hạnLàm mới Token hoặc đăng nhập lại trước khi thử lại.
1003 Token, API Keyhoặc chữ ký không hợp lệKiểm tra API Key, payload chữ ký, chuỗi phần thân JSON yêu cầu, và thứ tự tham số truy vấn.
1006 nguồn IP sự không khớpKiểm tra cấu hình danh sách trắng API Key IP .
3004 yêu cầu trùng lặpKhông tái sử dụng cùng một chữ ký cho các đường dẫn liên quan đến lệnh. Tái tạo timestamp và signature.
Giới hạn 5003 giá được kích hoạtGiảm tần suất yêu cầu và sử dụng backoff theo cấp số nhân nếu thử lại.
Timestamp outside of tolerance windowGọi cho /v1/time để hiệu chỉnh khoảng thời gian và ký lại yêu cầu.