# Câu hỏi thường gặp

Câu trả lời ngắn, mỗi câu kèm link tới trang có chi tiết. Không thấy câu hỏi của bạn? Xem [Xử lý sự cố](https://docs.wandura.ai/vi/developers/production/troubleshooting) hoặc [Hỗ trợ](https://docs.wandura.ai/vi/developers/help/support).

## Key và quyền truy cập
### Tôi có thể gọi API từ trình duyệt hoặc app di động không?
Không. API là server-to-server: không có header CORS, và key nằm trong client thì có thể bị trích ra. App của bạn nói chuyện với backend của bạn. Xem [Bảo mật](https://docs.wandura.ai/vi/developers/concepts/security#trust-boundary).

### Tôi có tự tạo được key có scope `playback` không?
Có: bất kỳ Admin hoặc Developer nào, trên **Developers** → **Stream films in an app**. Xem [Xác thực](https://docs.wandura.ai/vi/developers/authentication#scopes).

### Tôi làm mất key. Wandura có hiện lại được không?
Không. Key chỉ hiện một lần. Hãy xoay vòng key đó hoặc tạo key mới.

### Xoay vòng key có gây gián đoạn không?
Có: secret cũ ngừng hoạt động trong vài giây, không có thời gian chồng lấn. Để không gián đoạn, hãy tạo key thứ hai, triển khai nó, rồi mới thu hồi key cũ; lưu ý phiên bản đã ghim. Xem [Bảo mật · Vòng đời key](https://docs.wandura.ai/vi/developers/concepts/security#key-lifecycle).

### Có sandbox không?
Không có host riêng. Bài test gọi production bằng key của **tổ chức test** của bạn: chỉ phim mẫu, lượt phát không được tính, lỗi giả lập khi cần. Xem [Testing](https://docs.wandura.ai/vi/developers/guides/testing).

## Catalog
### Catalog có phân trang không?
Tuỳ chọn. Không có `limit` thì bạn nhận tất cả trong một response; có `limit` (1–200 phim) thì bạn lật trang bằng `cursor`. Các trang không phải một ảnh chụp duy nhất: xem [Hành vi chuẩn của API · Phân trang](https://docs.wandura.ai/vi/developers/reference/behaviour#pagination).

### Một phim tôi được cấp phép lại bị thiếu. Vì sao?
Giấy phép phải đang hoạt động, hôm nay (UTC) nằm trong khung thời gian của nó, và phim đã được publish. Hãy kiểm tra ngày với Wandura. Xem [Catalog](https://docs.wandura.ai/vi/developers/concepts/catalog#what-is-in-the-catalog).

### Vì sao một số tập có `"id": null`?
Đó là placeholder cho các tập đã dự kiến ("sắp ra mắt"). Không bao giờ gửi chúng tới playback. Xem [Catalog](https://docs.wandura.ai/vi/developers/concepts/catalog#planned-episodes).

### `stream_ready` là `true`, nhưng playback báo `not_ready`. Có phải lỗi không?
Không. Catalog là một ảnh chụp; request xin vé kiểm tra lại. Hãy hiện "Chưa khả dụng" và đồng bộ lại.

## Playback
### Tôi có thể xin vé cho nhiều tập trong một lệnh gọi không?
Có: tối đa 3 vé mỗi lệnh gọi, bằng `episodes` hoặc bằng một tập kèm `next`. Mỗi vé tính 1 vào giới hạn của bạn. Xem [Xin playback](https://docs.wandura.ai/vi/developers/reference/playback).

### Tôi có thể cache vé playback không?
Có, theo người xem, **thiết bị**, tập và intent, cho đến 5 phút trước `expires_at`. Không bao giờ dùng chung giữa các thiết bị: vé chỉ giải mã được trên thiết bị nó được cấp cho. Với `viewer_ref` ổn định, Wandura làm việc này giúp bạn. Xem [Hành vi chuẩn của API · Tái sử dụng](https://docs.wandura.ai/vi/developers/reference/behaviour#ticket-reuse).

### Vì sao tôi nhận `409 sdk_required` hoặc `400 invalid_device_info`?
Các giá trị thiết bị từ Player SDK bị thiếu (`409`) hoặc trông như rỗng, ví dụ `"(null)"` (`400`). Xem [Playback và vé](https://docs.wandura.ai/vi/developers/concepts/playback#send-the-device-values).

### Tôi có thể phát tập bằng HLS player thông thường không?
Không: nó tải playlist rồi đứng hình. Hãy dùng Player SDK. Xem [Player SDK](https://docs.wandura.ai/vi/developers/player-sdk).

### Request prefetch có tính là lượt phát không?
Không, nếu có `"intent": "prefetch"`. Chúng vẫn tính vào rate limit của bạn. Request không có `intent`, hoặc có giá trị khác, được tính là lượt phát.

### Phụ đề lấy từ đâu?
Từ mỗi vé, dưới dạng file WebVTT. Xem [Phụ đề](https://docs.wandura.ai/vi/developers/guides/subtitles).

## Creative
### Feed có kèm file video không?
Không kèm file. Bản ghi mô tả từng creative và không bao giờ chứa URL media đã ký. `final.file_url` của bản ghi là link chia sẻ công khai tới video cuối, không cần API key, nên đưa thẳng cho video upload của Meta được: xem [Tải file cuối](https://docs.wandura.ai/vi/developers/concepts/creatives#downloading-the-final-file).

### Làm sao biết một creative đã bị rút?
`GET /creatives/{id}` trả `404` `4040`. Không có sự kiện xoá. Xem [Đồng bộ creative](https://docs.wandura.ai/vi/developers/guides/creatives-sync).

### Vì sao cùng một creative lại đến hai lần?
Đồng bộ incremental có thể lặp lại một bản ghi. Hãy ghi đè theo `creative_id`.
