Lịch sử: Developer key

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

02/10/2026 · +14 −25 dòng

Xem thay đổi

⋯
  API key cho phép backend của tổ chức bạn gọi Wandura Delivery API. Thành viên có vai trò **developer** hoặc **admin** tự tạo, xoay vòng và thu hồi key trên màn hình **Developers** của cổng đối tác. Trang này hướng dẫn phía cổng; về cách gửi key trong mỗi request, xem [Xác thực](../developers/authentication.md).
  
- ## Mở màn hình Developers
+ ## Mở màn hình Developers {#open-the-developers-screen}
  
  - **Developer** đăng nhập là vào thẳng màn hình này; đây là màn hình duy nhất họ có.
⋯
  Nếu bạn cần màn hình này mà không thấy, hãy nhờ admin của tổ chức cấp cho bạn vai trò developer. Xem [Team và tổ chức](team.md).
  
- ## Scope
- 
- Mỗi key mang một hoặc nhiều scope. Key chỉ gọi được các endpoint mà scope của nó cho phép.
- 
- | Scope | Tên hiển thị trong cổng | Ai tạo |
- |---|---|---|
- | `metadata:read` | Read film metadata | Bạn, trong cổng |
- | `creatives:export` | Receive exported creatives | Bạn, trong cổng |
- | `webhooks:manage` | Manage webhooks | Bạn, trong cổng |
- | `playback` | Play films | Bạn, trong cổng |
- 
- Để stream phim trong app, hãy chọn **Stream films in an app** khi tạo key. Key nhận `metadata:read` và `playback`.
+ ## Scope {#scopes}
  
- > **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. Hãy thu hồi ngay. Cổng hiện cảnh báo này trên thẻ chọn và một lần nữa cạnh key mới. 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).
+ Mỗi key mang một hoặc nhiều scope, và chỉ gọi được các endpoint mà scope của nó cho phép. Scope nào mở endpoint nào nằm trong một bảng duy nhất: [Xác thực · Scope](../developers/authentication.md#scopes).
  
- [Tài liệu tham chiếu API](../developers/reference/overview.md) liệt kê endpoint nào cần scope nào.
+ > **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. Hãy thu hồi ngay. Cổng hiện cảnh báo này trên thẻ chọn và một lần nữa cạnh key mới.
  
- ## Tạo key
+ ## Tạo key {#create-a-key}
  
  1. Mở **Developers**.
  2. Trong **Create a key**, nhập **Label** cho biết key được dùng ở đâu, ví dụ `cms-prod`. Tối đa 80 ký tự.
- 3. Đánh dấu ít nhất một scope. **Read film metadata** được đánh dấu sẵn.
+ 3. Trong **What will this key do?**, chọn một mục đích: **Stream films in an app**, **Stream open video (fitness…)** (sẽ yêu cầu bạn chọn một app), **Sync catalog to your CMS** hoặc **Receive creatives / webhooks**. Để tự chọn scope, chọn **Advanced: choose scopes**.
  4. Bấm **Create key**.
  5. Sao chép key từ hộp vừa hiện ra bằng **Copy key**, rồi lưu vào trình quản lý secret của bạn.
⋯
  Chỉ giữ key trên server của bạn. Không bao giờ đặt key trong trang web chạy trên trình duyệt, ứng dụng di động hay repository công khai.
  
- ## Danh sách key
+ ## Danh sách key {#the-key-list}
  
  Danh sách **Keys** hiển thị mọi key của tổ chức, mới nhất trước. Với mỗi key, bạn thấy:
⋯
  - Trạng thái: **Never used**, **Last used** *ngày giờ*, hoặc **Revoked**.
  
- ## Xoay vòng key
+ ## Xoay vòng key {#rotate-a-key}
  
  Xoay vòng thay secret của key và giữ nguyên nhãn cùng scope.
  
  1. Bấm **Rotate** trên key.
- 2. Xác nhận bằng **Rotate key**. Key hiện tại ngừng hoạt động ngay lập tức.
+ 2. Xác nhận bằng **Rotate key**. Secret hiện tại ngừng hoạt động trong vài giây (xem [Bảo mật](../developers/concepts/security.md#key-lifecycle)).
  3. Sao chép key mới từ hộp vừa hiện ra. Giống như key mới tạo, key này chỉ hiển thị một lần.
  
- Hãy cập nhật server ngay sau khi xoay vòng, vì các request dùng key cũ sẽ lỗi kể từ thời điểm đó. Bạn không xoay vòng được key đã thu hồi. Playback key xoay vòng như mọi key khác; để đổi không gián đoạn, hãy tạo playback key thứ hai, triển khai nó, rồi mới thu hồi key cũ.
+ Hãy cập nhật server ngay sau khi xoay vòng: không có thời gian chồng lấn. Key đã xoay vòng giữ nguyên phiên bản API đã ghim; key mới nhận phiên bản mới nhất. Bạn không xoay vòng được key đã thu hồi. Playback key xoay vòng như mọi key khác; để đổi không gián đoạn, hãy tạo playback key thứ hai, triển khai nó, rồi mới thu hồi key cũ.
  
- ## Thu hồi key
+ ## Thu hồi key {#revoke-a-key}
  
  1. Bấm **Revoke** trên key.
  2. Xác nhận bằng **Revoke key**.
  
- Mọi thứ đang dùng key sẽ ngừng hoạt động ngay lập tức, và thu hồi không thể hoàn tác. Key vẫn nằm trong danh sách với nhãn **Revoked**.
+ Request mới dùng key này bị từ chối trong vài giây, và thu hồi không thể hoàn tác. Vé đã cấp vẫn phát tiếp cho đến khi hết hạn (tối đa 30 phút). Key vẫn nằm trong danh sách với nhãn **Revoked**.
  
  | Loại key | Developer | Admin |
⋯
  | Mọi key của tổ chức, kể cả playback key | Xoay vòng, thu hồi | Xoay vòng, thu hồi |
  
- > **Cảnh báo:** Thu hồi playback key sẽ làm việc phát phim trong ứng dụng của bạn dừng ngay lập tức. Nếu nghi key đã bị lộ, vẫn thu hồi ngay, rồi tạo playback key mới cho server.
+ > **Cảnh báo:** Thu hồi playback key sẽ dừng việc phát mới trong app của bạn trong vài giây. Nếu nghi key đã bị lộ, vẫn thu hồi ngay, rồi tạo playback key mới cho server và báo cho Wandura. Quy trình đầy đủ: [Bảo mật · Nếu key bị lộ](../developers/concepts/security.md#leaked-key).
  
- ## Bước tiếp theo
+ ## Bước tiếp theo {#next-steps}
  
  - [Xác thực](../developers/authentication.md)
⋯

01/10/2026 · +8 −6 dòng

Xem thay đổi

⋯
  | `creatives:export` | Receive exported creatives | Bạn, trong cổng |
  | `webhooks:manage` | Manage webhooks | Bạn, trong cổng |
- | `playback` | Play films (granted by Wandura) | Chỉ Wandura |
+ | `playback` | Play films | Bạn, trong cổng |
  
+ Để stream phim trong app, hãy chọn **Stream films in an app** khi tạo key. Key nhận `metadata:read` và `playback`.
+ 
+ > **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. Hãy thu hồi ngay. Cổng hiện cảnh báo này trên thẻ chọn và một lần nữa cạnh key mới. 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).
+ 
  [Tài liệu tham chiếu API](../developers/reference/overview.md) liệt kê endpoint nào cần scope nào.
  
⋯
  - Các scope của key.
  - Trạng thái: **Never used**, **Last used** *ngày giờ*, hoặc **Revoked**.
- - **Managed by Wandura** trên các playback key.
  
  ## Xoay vòng key
⋯
  3. Sao chép key mới từ hộp vừa hiện ra. Giống như key mới tạo, key này chỉ hiển thị một lần.
  
- Hãy cập nhật server ngay sau khi xoay vòng, vì các request dùng key cũ sẽ lỗi kể từ thời điểm đó. Bạn không xoay vòng được key đã thu hồi hay playback key. Với playback key, hãy hỏi trong kênh Discord Wandura của team bạ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ũ, nên cả hai cùng chạy trong lúc chuyển.
+ Hãy cập nhật server ngay sau khi xoay vòng, vì các request dùng key cũ sẽ lỗi kể từ thời điểm đó. Bạn không xoay vòng được key đã thu hồi. Playback key xoay vòng như mọi key khác; để đổi không gián đoạn, hãy tạo playback key thứ hai, triển khai nó, rồi mới thu hồi key cũ.
  
  ## Thu hồi key
⋯
  | Loại key | Developer | Admin |
  |---|---|---|
- | Key bạn tạo trong cổng | Xoay vòng, thu hồi | Xoay vòng, thu hồi |
- | Playback key do Wandura cấp | Không được gì | Chỉ thu hồi |
+ | Mọi key của tổ chức, kể cả playback key | Xoay vòng, thu hồi | Xoay vòng, thu hồi |
  
- > **Cảnh báo:** Thu hồi playback key sẽ làm việc phát phim trong ứng dụng của bạn dừng ngay lập tức. Chỉ làm vậy trong trường hợp khẩn cấp, rồi xin key thay thế trong kênh Discord Wandura của team bạn.
+ > **Cảnh báo:** Thu hồi playback key sẽ làm việc phát phim trong ứng dụng của bạn dừng ngay lập tức. Nếu nghi key đã bị lộ, vẫn thu hồi ngay, rồi tạo playback key mới cho server.
  
  ## Bước tiếp theo
⋯

01/10/2026 · +2 −2 dòng

Xem thay đổi

⋯
  3. Sao chép key mới từ hộp vừa hiện ra. Giống như key mới tạo, key này chỉ hiển thị một lần.
  
- Hãy cập nhật server ngay sau khi xoay vòng, vì các request dùng key cũ sẽ lỗi kể từ thời điểm đó. Bạn không xoay vòng được key đã thu hồi hay playback key; với playback key, hãy liên hệ Wandura.
+ Hãy cập nhật server ngay sau khi xoay vòng, vì các request dùng key cũ sẽ lỗi kể từ thời điểm đó. Bạn không xoay vòng được key đã thu hồi hay playback key. Với playback key, hãy hỏi trong kênh Discord Wandura của team bạ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ũ, nên cả hai cùng chạy trong lúc chuyển.
  
  ## Thu hồi key
⋯
  | Playback key do Wandura cấp | Không được gì | Chỉ thu hồi |
  
- > **Cảnh báo:** Thu hồi playback key sẽ làm việc phát phim trong ứng dụng của bạn dừng ngay lập tức. Chỉ làm vậy trong trường hợp khẩn cấp, rồi liên hệ Wandura để xin key thay thế.
+ > **Cảnh báo:** Thu hồi playback key sẽ làm việc phát phim trong ứng dụng của bạn dừng ngay lập tức. Chỉ làm vậy trong trường hợp khẩn cấp, rồi xin key thay thế trong kênh Discord Wandura của team bạn.
  
  ## Bước tiếp theo
⋯

29/09/2026 · Tạo trang