Bản lưu ngày / Snapshot of 2026-10-02 · Xem bản mới nhất / See the latest version
WanduraDocsBeta
BetaDocs đang ở bản beta và còn thay đổi. Thấy chỗ sai, khó hiểu hoặc còn thiếu? Hãy cho chúng tôi biết.
Khái niệm

Video mở

Markdown
Trên trang này

TL;DR — Với video không có bản quyền cần giữ, ví dụ clip fitness ngắn, Wandura có một đường nhẹ hơn: server của bạn lấy danh sách video bằng key của từng app, và app phát thẳng link MP4 bằng bất kỳ player thông thường nào. Không vé, không giấy phép Player SDK, không mã hoá, và app không phải viết code để Wandura nhận ra app. Link sống 1 giờ; làm mới danh sách mỗi 45 phút.

Warning: Không dùng đường này cho phim drama hay bất cứ thứ gì có bản quyền cần giữ. Ai có link video mở đều phát hoặc tải về được, cho tới khi link hết hạn.

Khi nào dùng

Video mở Mô hình chuẩn
Clip tập luyện, hướng dẫn hay demo không có bản quyền cần giữ Phim drama và series
Nội dung bạn không ngại bị chia sẻ Mọi thứ bán, cấp phép theo phim hoặc nằm sau paywall

So sánh mọi mô hình: Kiến trúc.

Chạy thế nào

Video CDNWandura APIYour serverYour appGET /api/delivery/v1/videos (app key, videos:read)a page of videos with signed MP4 linkslinks from your server's cacheplay the MP4 link directlyvideo
  1. Đăng ký từng app và tạo key cho nó. Trên partner.wandura.ai → Developers → Apps, thêm từng app (tên, iOS bundle ID, Android package name), rồi tạo một key có Stream open video (fitness…) gắn với app đó. Mỗi app một key: danh tính của app nằm trong chữ ký của mọi link, và lưu lượng dữ liệu được tính cho app theo đó.
  2. Lấy danh sách bằng GET /api/delivery/v1/videos trên server của bạn, đi hết mọi trang.
  3. Phát từng link đúng như nhận được, bằng AVPlayer, ExoPlayer hoặc thẻ HTML <video>.
  4. Làm mới trước refresh_before (45 phút sau response). App lấy link từ server của bạn khi cần và không bao giờ lưu lại.

Vòng quét, kèm code không bao giờ thay danh sách của bạn bằng một danh sách thiếu: Đồng bộ video mở.

Hai endpoint

Endpoint Dùng để
GET /api/delivery/v1/videos Lấy cả danh mục, từng trang một. Đây là endpoint chính.
GET /api/delivery/v1/videos/{id} Lấy link mới cho một video bạn đã biết. Cùng hình dạng dòng.

Khuyến nghị: lấy danh sách trên server, cache lại, trả link từ cache. Nếu bạn gọi endpoint một video mỗi lượt phát, khả năng phát của bạn phụ thuộc vào việc Wandura có phản hồi đúng lúc đó hay không (danh sách đã cache vẫn phát được 45 phút), và số request tăng theo lượng người xem. Wandura không chặn cách nào: endpoint một video có rate limit riêng, nên dùng nhiều ở đó không bao giờ làm nghẹt endpoint danh sách. Ngưỡng: Hành vi chuẩn của API.

Luật cho link

  1. Link sống 1 giờ; làm mới trước refresh_before. Đừng tự tính khoảng an toàn từ expires_at.
  2. App không bao giờ lưu link. Link đã lưu sẽ lỗi 403 về sau, và chỉ thấy được trên thiết bị người xem.
  3. Không bao giờ sửa URL, kể cả query string: chữ ký bao trùm cả phần đó.
  4. Mỗi app một key. Link lấy bằng key của app A mà app B phát thì được tính cho A, và không sửa lại được.
  5. Link là quyền xem, không phải quyền sở hữu. Đừng công khai link.
  6. 429 và 503 nghĩa là retry, không phải "sai".

Một giờ là lựa chọn an toàn của Wandura, không phải giới hạn kỹ thuật; nếu làm mới mỗi 45 phút gây khó cho bạn, hãy nói với Wandura.

Khác gì so với phim

  • Không vé, không giá trị thiết bị, không giấy phép Player SDK.
  • Lưu lượng được báo theo từng app dựa trên chính link; Wandura không đếm từng lượt phát. Nếu cần, hãy tự ghi lượt xem trong app.
  • Quyền truy cập theo tổ chức: key của bạn chỉ thấy các bộ sưu tập được cấp cho bạn, sau khi đã publish.
  • Thu hồi key của một app chỉ chặn danh sách mới cho app đó; link đã phát ra sẽ hết hạn trong vòng một giờ.

Cập nhật 02/10/2026 · Lịch sử thay đổi (1)

↑↓ chọnEnter mởEsc đóng

Gửi góp ý

Góp ý được gửi thẳng tới đội Wandura, kèm địa chỉ trang này.

0 / 4000