> ## Documentation Index
> Fetch the complete documentation index at: https://docs.data-hub.verolabs.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Xử lý sự cố

> Các lỗi thường gặp khi gọi Vero Data Hub API

<div style={{ width: '100%', height: 240, marginBottom: 32, borderRadius: 16, overflow: 'hidden', position: 'relative' }}>
  <video style={{ width: '100%', height: '100%', objectFit: 'cover', filter: 'sepia(0.3) saturate(1.5) hue-rotate(-14deg) brightness(0.72) contrast(1.12)' }} autoPlay loop muted playsInline>
    <source src="https://mintcdn.com/vero-fa5575b5/G_sL_RHXpWEXOwUp/images/bg_video.mp4?fit=max&auto=format&n=G_sL_RHXpWEXOwUp&q=85&s=f731a6a676fb99a2368193fbaf3281ee" type="video/mp4" data-path="images/bg_video.mp4" />
  </video>
</div>

<div style={{ width: '100%', height: 4, marginBottom: 24, borderRadius: 2, background: 'rgba(0,0,0,0.08)' }}>
  <div style={{ width: '100%', height: '100%', borderRadius: 2, background: 'linear-gradient(90deg, var(--accent-primary) 0%, var(--accent-light) 50%, var(--accent-dark) 100%)' }} />
</div>

## Danh sách kiểm tra nhanh

<Steps>
  <Step title="Kiểm tra phương thức và đường dẫn">
    Đối chiếu yêu cầu với trang endpoint trong tham chiếu API.
  </Step>

  <Step title="Kiểm tra thông tin xác thực">
    Với `401`, kiểm tra API key được cấp cho tài khoản.
  </Step>

  <Step title="Kiểm tra định dạng thời gian">
    Dùng ISO 8601 UTC có hậu tố `Z` cho `from` và `to`.
  </Step>

  <Step title="Kiểm tra trạng thái phản hồi">
    Dùng tab phản hồi trong playground để xem từng mã trạng thái.
  </Step>
</Steps>

## Lỗi thường gặp

| Triệu chứng                   | Nguyên nhân thường gặp                                         | Cách xử lý                                                      |
| ----------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------- |
| `400 Invalid query parameter` | Thiếu tham số bắt buộc hoặc sai định dạng thời gian            | Kiểm tra tham số bắt buộc và dùng UTC `Z`                       |
| `401 Unauthorized`            | Thiếu hoặc sai thông tin xác thực                              | Kiểm tra API key                                                |
| `404 Not found`               | Mã giao dịch, mã quỹ, ID báo cáo hoặc ID tin tức không tồn tại | Dùng endpoint danh sách để tìm giá trị đúng                     |
| `422 Unprocessable`           | Đúng định dạng nhưng giá trị không được hỗ trợ                 | Kiểm tra các giá trị liệt kê như độ phân giải hoặc loại báo cáo |
| `429 Too many requests`       | Vượt giới hạn yêu cầu                                          | Giảm tần suất yêu cầu và thử lại sau                            |
| `503 Unavailable`             | API tạm thời không sẵn sàng                                    | Thử lại với backoff                                             |

## Ví dụ định dạng thời gian

| Hợp lệ                     | Không hợp lệ                |
| -------------------------- | --------------------------- |
| `2026-05-15T00:00:00Z`     | `2026-05-15 00:00:00`       |
| `2026-05-15T00:00:00.123Z` | `2026-05-15T07:00:00+07:00` |

## Thông tin nên gửi khi cần hỗ trợ

| Thông tin         | Ví dụ                                          |
| ----------------- | ---------------------------------------------- |
| Endpoint          | `GET /v1/candles`                              |
| Tham số truy vấn  | `symbol=BTCUSDT&resolution=5m&from=...&to=...` |
| Trạng thái HTTP   | `400`, `401`, `404`, `429`, `503`              |
| Nội dung phản hồi | Phản hồi JSON hoặc nội dung lỗi                |
| Thời điểm request | UTC timestamp                                  |