Lịch sử: Câu hỏi thường gặp

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

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

1. 02/10/2026 · +41 −45 dòng
   Xem thay đổi

     # Câu hỏi thường gặp
     
   - Giải đáp những câu hỏi developer hay gặp nhất khi tích hợp Wandura Delivery API. Nếu câu hỏi của bạn không có ở đây, xem [Hỗ trợ](support.md).
   - 
   - ## 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?
   + 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ố](../production/troubleshooting.md) hoặc [Hỗ trợ](support.md).
     
   - Không. API là server-to-server: các endpoint không gửi header CORS, và API key không bao giờ được nằm trong client. App của bạn nói chuyện với backend của bạn, và backend của bạn nói chuyện với Wandura.
   + ## Key và quyền truy cập {#keys-and-access}
     
   - ### Tôi có tự tạo được key có scope `playback` không?
   + ### Tôi có thể gọi API từ trình duyệt hoặc app di động không? {#can-i-call-the-api-from-a-browser-or-a-mobile-app}
     
   - Có. Bất kỳ **Admin** hoặc **Developer** nào của tổ chức cũng tạo được trên **Developers** bằng cách chọn **Stream films in an app**. Nếu playback key bị lộ, bất kỳ ai cũng stream được các phim bạn được cấp phép, nên hãy giữ key trên server và thu hồi ngay nếu nghi bị lộ. Xem [Xác thực](../authentication.md#scopes).
   + 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](../concepts/security.md#trust-boundary).
     
   - ### Tôi làm mất key. Wandura có hiện lại key cho tôi được không?
   + ### Tôi có tự tạo được key có scope `playback` không? {#can-i-create-a-key-with-the-playback-scope-myself}
     
   - Không. Key đầy đủ chỉ hiện một lần, lúc tạo. Hãy xoay vòng key đó hoặc tạo key mới trên trang **Developers**.
   + Có: bất kỳ Admin hoặc Developer nào, trên **Developers** → **Stream films in an app**. Xem [Xác thực](../authentication.md#scopes).
     
   - ### Xoay vòng key có gây gián đoạn không?
   + ### Tôi làm mất key. Wandura có hiện lại được không? {#i-lost-a-key-can-wandura-show-it-to-me-again}
     
   - Có: key cũ ngừng hoạt động ngay lập tức. Để chuyển đổi êm, hãy tạo key thứ hai, triển khai nó, rồi mới thu hồi key cũ. Playback key cũng làm y như vậy.
   + Không. Key chỉ hiện một lần. Hãy xoay vòng key đó hoặc tạo key mới.
     
   - ### Có sandbox không?
   + ### Xoay vòng key có gây gián đoạn không? {#does-rotating-a-key-cause-downtime}
     
   - Không. Mọi môi trường đều gọi `https://www.wandura.ai`. Bạn test bằng key của mình, trong tổ chức Wandura chọn để test, và lượt phát test được ghi nhận như mọi lượt khác. Xem [Test và production](../integration-guide.md#test-and-production).
   + 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](../concepts/security.md#key-lifecycle).
     
   - ## Catalog
   + ### Có sandbox không? {#is-there-a-sandbox}
     
   - ### Một phim tôi được cấp phép lại không có trong catalog. Vì sao?
   + 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](../guides/testing.md).
     
   - Catalog chỉ liệt kê một phim khi giấy phép streaming của bạn cho phim đó đang hoạt động, hôm nay nằm trong khung thời gian của giấy phép (theo UTC), và phim đã được publish. Hãy kiểm tra ngày của giấy phép với Wandura.
   + ## Catalog {#catalog}
     
   - ### Vì sao một số tập có `"id": null`?
   + ### Catalog có phân trang không? {#is-the-catalog-paginated}
     
   - Đó là placeholder cho các tập đã dự kiến nhưng chưa publish, để bạn hiển thị ô "sắp ra mắt". Chúng luôn có `"status": "planned"` và `"stream_ready": false`. Xem [Catalog](../concepts/catalog.md#planned-episodes).
   + 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](../reference/behaviour.md#pagination).
     
   - ### Catalog báo `stream_ready: true`, nhưng playback trả `not_ready`. Đó có phải lỗi không?
   + ### Một phim tôi được cấp phép lại bị thiếu. Vì sao? {#a-film-i-licensed-is-missing-from-the-catalog-why}
     
   - Không. `stream_ready` là ảnh chụp tại lúc bạn tải catalog. Playback kiểm tra lại ở mọi request, và một phim có thể bị rút trong khoảng giữa. Hãy hiển thị "chưa khả dụng" và làm mới catalog.
   + 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](../concepts/catalog.md#what-is-in-the-catalog).
     
   - ### Làm sao biết tập nào miễn phí?
   + ### Vì sao một số tập có `"id": null`? {#why-do-some-episodes-have-id-null}
     
   - Tập có `episode_no` nhỏ hơn hoặc bằng `free_until_episode` của phim là miễn phí. Hãy đọc giá trị này từ catalog; nó khác nhau giữa các phim.
   + Đó 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](../concepts/catalog.md#planned-episodes).
     
   - ## Playback
   + ### `stream_ready` là `true`, nhưng playback báo `not_ready`. Có phải lỗi không? {#the-catalog-said-stream-ready-true-but-playback-returned-not-ready-is-that-a-bug}
     
   - ### Vì sao tôi nhận `409 sdk_required`?
   + 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.
     
   - Các tập được cấp phép đều đã mã hoá và chỉ phát được qua Player SDK. Hãy gửi kèm request các giá trị thiết bị `union_info` và `drm_kek` lấy từ SDK. Xem [Playback](../concepts/playback.md#send-the-device-values).
   + ## Playback {#playback}
     
   - ### Vì sao tôi nhận `400 invalid_device_info`?
   + ### Tôi có thể xin vé cho nhiều tập trong một lệnh gọi không? {#can-i-request-tickets-for-several-episodes-in-one-call}
     
   - Một trong các giá trị thiết bị trông như rỗng, ví dụ chuỗi `"(null)"` theo nghĩa đen. Điều này thường xảy ra khi một lệnh gọi SDK không trả về gì và code của bạn chuyển nó thành văn bản. Mảng `fields` cho bạn biết cần sửa giá trị nào.
   + 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](../reference/playback.md).
     
   - ### Tôi có thể phát tập bằng HLS player thông thường không?
   + ### Tôi có thể cache vé playback không? {#can-i-cache-playback-tickets}
     
   - Không. Player thông thường sẽ tải playlist rồi đứng hình. Hãy dùng Player SDK: Wandura đăng ký app ID của bạn và cấp license Player SDK; tổ chức của bạn trả tiền license đó. Hướng dẫn cài nằm ở partner.wandura.ai → **Developers** → **Player SDK**, có sau khi [onboarding](../before-you-start.md#get-onboarded).
   + 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](../reference/behaviour.md#ticket-reuse).
     
   - ### Tôi có thể cache vé playback không?
   + ### Vì sao tôi nhận `409 sdk_required` hoặc `400 invalid_device_info`? {#why-do-i-get-409-sdk-required}
     
   - Không. Vé hết hạn 30 phút sau khi được cấp. Hãy xin một vé cho mỗi lần bắt đầu phát, và xin vé mới nếu player lỗi giữa phiên.
   + 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é](../concepts/playback.md#send-the-device-values).
     
   - ### Tôi có thể xin vé cho nhiều tập trong một lệnh gọi không?
   + ### Tôi có thể phát tập bằng HLS player thông thường không? {#can-i-play-episodes-with-a-standard-hls-player}
     
   - Không. Mỗi request chỉ dành cho một tập. Nếu app tải trước tập kế tiếp, hãy xin vé cho tập đó riêng và gửi `"intent": "prefetch"`.
   + Không: nó tải playlist rồi đứng hình. Hãy dùng Player SDK. Xem [Player SDK](../player-sdk/index.md).
     
   - ### Request prefetch có tính là lượt phát không?
   + ### Request prefetch có tính là lượt phát không? {#do-prefetch-requests-count-as-plays}
     
   - Không, nếu bạn gửi `"intent": "prefetch"`. Khi không có `intent`, hoặc có giá trị khác `play` và `prefetch`, mọi request xin vé thành công đều tính là một lượt phát. Request prefetch vẫn tính vào rate limit của bạn.
   + 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?
   + ### Phụ đề lấy từ đâu? {#where-do-subtitles-come-from}
     
   - Mọi response playback đều có mảng `subtitles` gồm các file WebVTT. Mảng rỗng nghĩa là chưa có phụ đề nào được gắn. Xem [Playback](../concepts/playback.md#subtitles).
   + Từ mỗi vé, dưới dạng file WebVTT. Xem [Phụ đề](../guides/subtitles.md).
     
   - ## Creative
   + ## Creative {#creatives}
     
   - ### Feed creative có kèm file video không?
   + ### Feed có kèm file video không? {#does-the-creatives-feed-include-video-files}
     
   - Không. Bản ghi mô tả từng creative nhưng không bao giờ có URL media. Hãy hỏi Wandura file hoàn chỉnh đến hệ thống của bạn bằng cách nào.
   + Không. Bản ghi mô tả từng creative; hãy hỏi Wandura file hoàn chỉnh đến tay bạn bằng cách nào.
     
   - ### Làm sao biết một creative đã bị rút?
   + ### Làm sao biết một creative đã bị rút? {#how-do-i-find-out-a-creative-was-withdrawn}
     
   - Feed không có sự kiện xoá. Hãy gọi `GET /creatives/{id}`: creative không còn khả dụng sẽ trả `404` với `code` `4040`.
   + `GET /creatives/{id}` trả `404` `4040`. Không có sự kiện xoá. Xem [Đồng bộ creative](../guides/creatives-sync.md).
     
   - ### Vì sao cùng một creative lại đến hai lần?
   + ### Vì sao cùng một creative lại đến hai lần? {#why-did-the-same-creative-arrive-twice}
     
   - Đồng bộ incremental có thể trả lại một bản ghi. Hãy lưu bản ghi theo khoá `creative_id` và ghi đè. Xem [Creative](../concepts/creatives.md#syncing-incrementally).
   + Đồng bộ incremental có thể lặp lại một bản ghi. Hãy ghi đè theo `creative_id`.

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

   ⋯
     Không. API là server-to-server: các endpoint không gửi header CORS, và API key không bao giờ được nằm trong client. App của bạn nói chuyện với backend của bạn, và backend của bạn nói chuyện với Wandura.
     
   - ### Vì sao tôi không tạo được key có scope `playback`?
   + ### Tôi có tự tạo được key có scope `playback` không?
     
   - Playback key có thể stream các phim bạn được cấp phép, nên chỉ Wandura cấp loại key này. Bạn tự tạo được key có `metadata:read`, `creatives:export` và `webhooks:manage`. Xem [Xác thực](../authentication.md#scopes).
   + Có. Bất kỳ **Admin** hoặc **Developer** nào của tổ chức cũng tạo được trên **Developers** bằng cách chọn **Stream films in an app**. Nếu playback key bị lộ, bất kỳ ai cũng stream được các phim bạn được cấp phép, nên hãy giữ key trên server và thu hồi ngay nếu nghi bị lộ. Xem [Xác thực](../authentication.md#scopes).
     
     ### Tôi làm mất key. Wandura có hiện lại key cho tôi được không?
   ⋯
     ### Xoay vòng key có gây gián đoạn không?
     
   - Có: key cũ ngừng hoạt động ngay lập tức. Để chuyển đổi êm, hãy tạo key thứ hai, triển khai nó, rồi mới thu hồi key cũ. Với playback key, Wandura làm việc này cho bạn: Wandura tạo playback key mới, bạn triển khai nó, rồi Wandura thu hồi key cũ.
   + Có: key cũ ngừng hoạt động ngay lập tức. Để chuyển đổi êm, hãy tạo key thứ hai, triển khai nó, rồi mới thu hồi key cũ. Playback key cũng làm y như vậy.
     
     ### Có sandbox không?
   ⋯

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

   ⋯
     ### Xoay vòng key có gây gián đoạn không?
     
   - Có: key cũ ngừng hoạt động ngay lập tức. Để chuyển đổi êm, hãy tạo key thứ hai, triển khai nó, rồi mới thu hồi key cũ.
   + Có: key cũ ngừng hoạt động ngay lập tức. Để chuyển đổi êm, hãy tạo key thứ hai, triển khai nó, rồi mới thu hồi key cũ. Với playback key, Wandura làm việc này cho bạn: Wandura tạo playback key mới, bạn triển khai nó, rồi Wandura thu hồi key cũ.
     
   + ### Có sandbox không?
   + 
   + Không. Mọi môi trường đều gọi `https://www.wandura.ai`. Bạn test bằng key của mình, trong tổ chức Wandura chọn để test, và lượt phát test được ghi nhận như mọi lượt khác. Xem [Test và production](../integration-guide.md#test-and-production).
   + 
     ## Catalog
     
   ⋯
     ### Tôi có thể phát tập bằng HLS player thông thường không?
     
   - Không. Player thông thường sẽ tải playlist rồi đứng hình. Hãy dùng Player SDK mà Wandura cấp phép cho bạn trong quá trình onboarding.
   + Không. Player thông thường sẽ tải playlist rồi đứng hình. Hãy dùng Player SDK: Wandura đăng ký app ID của bạn và cấp license Player SDK; tổ chức của bạn trả tiền license đó. Hướng dẫn cài nằm ở partner.wandura.ai → **Developers** → **Player SDK**, có sau khi [onboarding](../before-you-start.md#get-onboarded).
     
     ### Tôi có thể cache vé playback không?
   ⋯
     ### Request prefetch có tính là lượt phát không?
     
   - Không, nếu bạn gửi `"intent": "prefetch"`. Khi không có `intent`, mọi request xin vé thành công đều tính là một lượt phát. Request prefetch vẫn tính vào rate limit của bạn.
   + Không, nếu bạn gửi `"intent": "prefetch"`. Khi không có `intent`, hoặc có giá trị khác `play` và `prefetch`, mọi request xin vé thành công đều tính là một lượt phát. Request prefetch vẫn tính vào rate limit của bạn.
     
     ### Phụ đề lấy từ đâu?
   ⋯

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

   ⋯
     ### Một phim tôi được cấp phép lại không có trong catalog. Vì sao?
     
   - Catalog chỉ liệt kê một phim khi giấy phép streaming của bạn cho phim đó đang hoạt động, hôm nay nằm trong khung thời gian của giấy phép (theo UTC), và phim đã được publish. Hãy kiểm tra ngày của giấy phép với đầu mối đối tác Wandura của bạn.
   + Catalog chỉ liệt kê một phim khi giấy phép streaming của bạn cho phim đó đang hoạt động, hôm nay nằm trong khung thời gian của giấy phép (theo UTC), và phim đã được publish. Hãy kiểm tra ngày của giấy phép với Wandura.
     
     ### Vì sao một số tập có `"id": null`?
   ⋯
     ### Feed creative có kèm file video không?
     
   - Không. Bản ghi mô tả từng creative nhưng không bao giờ có URL media. Hãy hỏi đầu mối đối tác Wandura của bạn file hoàn chỉnh đến hệ thống của bạn bằng cách nào.
   + Không. Bản ghi mô tả từng creative nhưng không bao giờ có URL media. Hãy hỏi Wandura file hoàn chỉnh đến hệ thống của bạn bằng cách nào.
     
     ### Làm sao biết một creative đã bị rút?
   ⋯

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