Lịch sử thay đổi
Mọi lần sửa trang này, mới nhất ở trên. Mở từng mục để xem đã đổi gì.
- 01/10/2026 · +7 −5 dòng
Xem thay đổi
⋯ | `creatives:export` | Receive exported creatives | `GET /api/delivery/v1/creatives` và `GET /api/delivery/v1/creatives/{id}` | Bạn, trên trang **Developers** | | `webhooks:manage` | Manage webhooks | Chưa có endpoint nào dùng scope này | Bạn, trên trang **Developers** | - | `playback` | Play films (granted by Wandura) | `POST /api/delivery/v1/playback` | Chỉ Wandura | + | `playback` | Play films | `POST /api/delivery/v1/playback` | Bạn, trên trang **Developers** | - Bạn không thể tự tạo key có scope `playback`. Một playback key bị lộ sẽ cho phép bất kỳ ai stream các phim bạn được cấp phép, nên Wandura cấp trực tiếp các key này. Khi sẵn sàng tích hợp playback, hãy xin key từ Wandura. + Bạn tự tạo key có scope `playback` như mọi key khác: trên **Developers**, chọn **Stream films in an app**. Key nhận `metadata:read` và `playback`, nên cùng một server vừa liệt kê được phim vừa xin được vé. + > **Cảnh báo:** Nếu playback key bị lộ, bất kỳ ai cũng stream được các phim bạn được cấp phép. Chỉ giữ key trên server, và thu hồi ngay nếu nghi key đã bị lộ. Mỗi lần có playback key mới, hoặc một playback key được xoay vòng, Wandura nhận một cảnh báo ghi tổ chức của bạn, người tạo và tiền tố của key (không bao giờ ghi bản thân key). + Chỉ cấp cho mỗi key những scope nó cần. Một job đồng bộ marketing cần `creatives:export`, không cần `playback`. ⋯ 1. Mở **Developers** và tìm **Create a key**. 2. Nhập **Label** (tối đa 80 ký tự) cho biết key chạy ở đâu, ví dụ `catalog-sync-prod`. - 3. Chọn ít nhất một scope. + 3. Chọn key dùng để làm gì, ví dụ **Stream films in an app** cho playback key, hoặc tự chọn scope trong **Advanced: choose scopes**. 4. Chọn **Create key**, rồi sao chép key trước khi đóng thông báo. ⋯ > **Cảnh báo:** Key cũ ngừng hoạt động ngay khi bạn xác nhận. Để xoay vòng mà không gián đoạn, hãy tạo key thứ hai với cùng scope, triển khai nó, rồi mới thu hồi key cũ. - Key đã thu hồi không xoay vòng được; hãy tạo key mới. Key có scope `playback` do Wandura xoay vòng: portal đánh dấu chúng là **Managed by Wandura** và không có nút **Rotate**. Hãy hỏi trong kênh Discord Wandura của team bạn. Để đổi không gián đoạn, Wandura tạo một playback key mới bên cạnh key cũ, bạn triển khai key mới, rồi Wandura thu hồi key cũ; trong lúc chuyển cả hai key đều chạy. + Key đã thu hồi không xoay vòng được; hãy tạo key mới. Key có scope `playback` xoay vòng y như vậy, do bất kỳ **Admin** hoặc **Developer** nào của tổ chức bạn. Với playback key, đổi không gián đoạn càng quan trọng: tạo playback key thứ hai, triển khai nó, rồi mới thu hồi key cũ. ## Thu hồi key ⋯ Chọn **Revoke** cạnh key và xác nhận. Mọi thứ đang dùng key ngừng hoạt động ngay lập tức, và key đã thu hồi không khôi phục được. - Developer có thể thu hồi các key được tạo trên portal. Chỉ **Admin** của tổ chức mới thu hồi được key có scope `playback`. Hãy dùng việc này như công tắc khẩn cấp nếu nghi playback key bị lộ, rồi xin Wandura key thay thế. + Bất kỳ **Admin** hoặc **Developer** nào của tổ chức cũng thu hồi được mọi key của tổ chức, kể cả key có scope `playback` và key Wandura tạo giúp bạn. Nếu nghi playback key bị lộ, hãy thu hồi ngay: đó là công tắc khẩn cấp của bạn. Sau đó tạo playback key mới cho server. ## Liên quan ⋯
- 01/10/2026 · +1 −1 dòng
Xem thay đổi
⋯ > **Cảnh báo:** Key cũ ngừng hoạt động ngay khi bạn xác nhận. Để xoay vòng mà không gián đoạn, hãy tạo key thứ hai với cùng scope, triển khai nó, rồi mới thu hồi key cũ. - Key đã thu hồi không xoay vòng được; hãy tạo key mới. Key có scope `playback` do Wandura xoay vòng: portal đánh dấu chúng là **Managed by Wandura** và không có nút **Rotate**. Hãy nhờ Wandura xoay vòng giúp. + Key đã thu hồi không xoay vòng được; hãy tạo key mới. Key có scope `playback` do Wandura xoay vòng: portal đánh dấu chúng là **Managed by Wandura** và không có nút **Rotate**. Hãy hỏi trong kênh Discord Wandura của team bạn. Để đổi không gián đoạn, Wandura tạo một playback key mới bên cạnh key cũ, bạn triển khai key mới, rồi Wandura thu hồi key cũ; trong lúc chuyển cả hai key đều chạy. ## Thu hồi key ⋯
- 01/10/2026 · +2 −2 dòng
Xem thay đổi
⋯ | `playback` | Play films (granted by Wandura) | `POST /api/delivery/v1/playback` | Chỉ Wandura | - Bạn không thể tự tạo key có scope `playback`. Một playback key bị lộ sẽ cho phép bất kỳ ai stream các phim bạn được cấp phép, nên Wandura cấp trực tiếp các key này. Khi sẵn sàng tích hợp playback, hãy xin key từ đầu mối đối tác Wandura của bạn. + Bạn không thể tự tạo key có scope `playback`. Một playback key bị lộ sẽ cho phép bất kỳ ai stream các phim bạn được cấp phép, nên Wandura cấp trực tiếp các key này. Khi sẵn sàng tích hợp playback, hãy xin key từ Wandura. Chỉ cấp cho mỗi key những scope nó cần. Một job đồng bộ marketing cần `creatives:export`, không cần `playback`. ⋯ > **Cảnh báo:** Key cũ ngừng hoạt động ngay khi bạn xác nhận. Để xoay vòng mà không gián đoạn, hãy tạo key thứ hai với cùng scope, triển khai nó, rồi mới thu hồi key cũ. - Key đã thu hồi không xoay vòng được; hãy tạo key mới. Key có scope `playback` do Wandura xoay vòng: portal đánh dấu chúng là **Managed by Wandura** và không có nút **Rotate**. Hãy nhờ đầu mối đối tác Wandura xoay vòng giúp. + Key đã thu hồi không xoay vòng được; hãy tạo key mới. Key có scope `playback` do Wandura xoay vòng: portal đánh dấu chúng là **Managed by Wandura** và không có nút **Rotate**. Hãy nhờ Wandura xoay vòng giúp. ## Thu hồi key ⋯
- 30/09/2026 · +1 −1 dòng
Xem thay đổi
⋯ Chữ `Bearer`, một dấu cách, rồi đến key. Key bắt đầu bằng `wnd_live_`, giúp công cụ quét secret phát hiện key lỡ bị commit. - Thiếu header, header sai định dạng, hoặc key đã bị thu hồi hay không tồn tại đều trả về `401`. API không dùng cookie và không có danh tính theo từng người dùng: một key đại diện cho cả tổ chức. + Thiếu header, header sai định dạng, hoặc key đã bị thu hồi hay không tồn tại đều trả về `401`. Nếu Wandura chưa kiểm được key kịp lúc, bạn nhận `503` với `error_code` `service_unavailable` (creatives: `code` `5031`) kèm header `Retry-After`: key vẫn đúng, hãy thử lại chứ đừng xoay key. API không dùng cookie và không có danh tính theo từng người dùng: một key đại diện cho cả tổ chức. ## Scope {#scopes} ⋯
- 29/09/2026 · Tạo trang