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ố hoặc Hỗ trợ.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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é.

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.

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ụ đề.

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.

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.

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.