Lịch sử: Lỗi

Mọi lần sửa trang này, mới nhất ở trên. Mở từng mục để xem đã đổi gì.

← Lỗi

1. 01/10/2026 · +2 −1 dòng
   Xem thay đổi

   ⋯
     | 400 | `invalid_device_info` | Một giá trị thiết bị trông như rỗng hoặc không hợp lệ, ví dụ chuỗi `"(null)"`. `fields` nêu các giá trị sai. | Sửa cách app đọc giá trị từ Player SDK. |
     | 401 | không có | API key bị thiếu, không hợp lệ hoặc đã bị thu hồi. | Kiểm tra key. Không retry. |
   - | 403 | không có | Key thiếu scope `playback`. | Dùng playback key mà Wandura cấp cho bạn. |
   + | 403 | không có | Key thiếu scope `playback`. | Dùng một playback key: tạo trên **Developers** → **Stream films in an app**. |
     | 403 | `not_entitled` | Tổ chức của bạn hiện không được cấp phép stream phim này. `reason` cho biết chi tiết. | Hiển thị trạng thái khoá hoặc không khả dụng. Không retry. |
     | 404 | `not_ready` | Tập hoặc phim không tồn tại, chưa publish, hoặc chưa sẵn sàng để stream. | Hiển thị "chưa khả dụng". Làm mới catalog. |
   ⋯
     | 503 | `not_ready` | Hiện chưa có phiên bản phát được của tập này. | Hiển thị "chưa khả dụng". Thử lại sau. |
     | 503 | `service_unavailable` | Wandura chưa kiểm được API key kịp lúc. Key **không** sai. | Chờ đúng `Retry-After` giây rồi thử lại, có backoff. Đừng xoay key. |
   + | 503 | `service_unavailable` | Nhà cung cấp video chưa trả lời kịp (chỉ ở playback). Tập phim và key đều không có vấn đề. | Chờ đúng `Retry-After` giây (2) rồi thử lại, có backoff. |
     
     ### Các `reason` của `not_entitled`
   ⋯

2. 01/10/2026 · +1 −1 dòng
   Xem thay đổi

   ⋯
     | Trường | Kiểu | Mô tả |
     |---|---|---|
   - | `error` | string | Thông điệp cho người đọc. Hãy ghi log, nhưng đừng parse. |
   + | `error` | string | Thông điệp cho người đọc. Hãy ghi log, nhưng đừng parse, trừ `403` của catalog bên dưới. |
     | `error_code` | string | Mã máy đọc được. Rẽ nhánh theo trường này. Một số lỗi không có trường này, bảng bên dưới ghi là "không có". |
     | `reason` | string | Chỉ có với `not_entitled`: lý do chi tiết, dùng cho log và hỗ trợ. |
   ⋯

3. 01/10/2026 · +2 −2 dòng
   Xem thay đổi

   ⋯
     | 401 | không có | `Invalid or revoked API key` | Key không tồn tại hoặc đã bị thu hồi. | Kiểm tra key. Không retry. |
     | 403 | không có | `This API key does not have the metadata:read scope` | Key thiếu scope. | Dùng key có `metadata:read`. |
   - | 403 | không có | `org_suspended` | Quyền truy cập của tổ chức bạn đang bị tạm ngưng. | Liên hệ đầu mối đối tác Wandura. Không retry. |
   + | 403 | không có | `org_suspended` | Quyền truy cập của tổ chức bạn đang bị tạm ngưng. | Liên hệ Wandura. Không retry. |
     | 429 | `rate_limited` | | Đã chạm rate limit. | Chờ hết `Retry-After`. |
     | 503 | `service_unavailable` | `Could not verify the API key right now — retry` | Wandura chưa kiểm được key kịp lúc. Key **không** sai. | Chờ đúng `Retry-After` giây rồi thử lại, có backoff. Đừng xoay key. |
   ⋯
     | 401 | 4011 | `Invalid or revoked API key` | Key không tồn tại hoặc đã bị thu hồi. | Kiểm tra key. Không retry. |
     | 403 | 4030 | `This API key does not have the creatives:export scope` | Key thiếu scope. | Dùng key có `creatives:export`. |
   - | 403 | 4031 | `org_suspended` | Quyền truy cập của tổ chức bạn đang bị tạm ngưng. | Liên hệ đầu mối đối tác Wandura. |
   + | 403 | 4031 | `org_suspended` | Quyền truy cập của tổ chức bạn đang bị tạm ngưng. | Liên hệ Wandura. |
     | 404 | 4040 | `Creative not found` | Chỉ với `GET /creatives/{id}`. Creative không tồn tại, thuộc tổ chức khác hoặc chưa được duyệt. | Gỡ nó khỏi tập creative đang dùng. |
     | 422 | 4220 | `limit must be an integer between 1 and 100` | Chỉ với endpoint liệt kê. `limit` sai. | Sửa request. |
   ⋯

4. 30/09/2026 · +3 −0 dòng
   Xem thay đổi

   ⋯
     | 403 | không có | `org_suspended` | Quyền truy cập của tổ chức bạn đang bị tạm ngưng. | Liên hệ đầu mối đối tác Wandura. Không retry. |
     | 429 | `rate_limited` | | Đã chạm rate limit. | Chờ hết `Retry-After`. |
   + | 503 | `service_unavailable` | `Could not verify the API key right now — retry` | Wandura chưa kiểm được key kịp lúc. Key **không** sai. | Chờ đúng `Retry-After` giây rồi thử lại, có backoff. Đừng xoay key. |
     
     ## Lỗi playback {#playback-errors}
   ⋯
     | 502 | không có | Wandura không chuẩn bị được stream hoặc không ký được play token. | Retry với backoff. |
     | 503 | `not_ready` | Hiện chưa có phiên bản phát được của tập này. | Hiển thị "chưa khả dụng". Thử lại sau. |
   + | 503 | `service_unavailable` | Wandura chưa kiểm được API key kịp lúc. Key **không** sai. | Chờ đúng `Retry-After` giây rồi thử lại, có backoff. Đừng xoay key. |
     
     ### Các `reason` của `not_entitled`
   ⋯
     | 429 | không có (body phẳng, `error_code` `rate_limited`) | | Đã chạm rate limit. | Chờ hết `Retry-After`. |
     | 503 | 5030 | `The creative feed is temporarily unavailable` | Sự cố tạm thời phía Wandura. | Retry với backoff. |
   + | 503 | 5031 | `Could not verify the API key right now — retry` | Wandura chưa kiểm được key kịp lúc. Key **không** sai. | Retry với backoff. Đừng xoay key. |
     
     ## Hướng dẫn retry
   ⋯

5. 29/09/2026 · Tạo trang