3. Vấn đề kỹ thuật khi tích hợp
Rate limit, chữ ký request, xử lý lỗi, môi trường test, và kênh hỗ trợ.
Gặp lỗi 429 Too Many Requests thì xử lý thế nào?
Bạn đã vượt rate limit. Trước mắt, đợi đến thời điểm trong header X-RATELIMIT-RESET rồi gọi lại. Về lâu dài: giảm tần suất gọi, cache dữ liệu ít thay đổi, và dùng WebSocket thay vì polling cho dữ liệu realtime.
Chữ ký request (signature) cho các API giao dịch được tính như thế nào?
Các lệnh mutating (đặt/sửa/hủy lệnh) yêu cầu header X-Signature — chữ ký RSA+SHA256 tính trên nội dung request body bằng SecretKey của API Key, theo quy định UBCKNN về toàn vẹn dữ liệu giao dịch. Chi tiết tham số và ví dụ tính chữ ký xem tại tài liệu Authentication.
Response lỗi có cấu trúc thế nào, làm sao xử lý nhất quán?
Response lỗi REST có dạng { "code": ..., "msg": ... }; response lỗi WebSocket API có dạng { "id", "status", "error": { "code", "message" } }. Nên chuẩn hóa việc map code sang hành động cụ thể trong ứng dụng của bạn — xem đầy đủ bảng mã lỗi tại phụ lục Tra cứu mã lỗi (ErrCode).
Làm sao test tích hợp mà không ảnh hưởng tài khoản/dữ liệu thật?
Dùng môi trường UAT — thông tin kết nối được cung cấp sau khi đăng ký trên Developer Portal, với bộ API Key riêng biệt hoàn toàn với Production.
Gặp lỗi không tự xử lý được thì liên hệ ai?
- Email: [email protected]
- Hotline: 1900 54 54 71
Khi báo lỗi, vui lòng cung cấp: endpoint/method đã gọi, request body (ẩn thông tin nhạy cảm), response body (bao gồm code/msg), thời điểm xảy ra, và mô tả ngắn gọn vấn đề để đội ngũ hỗ trợ xử lý nhanh hơn.