Developer key

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.

Mở màn hình Developers#

• 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ó.
• Admin tìm thấy nó trong Setup → Developers trên thanh bên.

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.

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.

Để 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 liệt kê endpoint nào cần scope nào.

Tạo 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.
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.
6. Bấm I saved it để đóng hộp.

Cảnh báo: Key đầy đủ chỉ hiển thị một lần. Wandura không hiển thị lại được. Nếu làm mất, hãy xoay vòng key hoặc tạo key mới.

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 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:

• Vài ký tự đầu của key theo sau là …, và nhãn của key.
• Các scope của key.
• Trạng thái: Never used, Last used ngày giờ, hoặc Revoked.

Xoay vòng 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.
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ũ.

Thu hồi 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.

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#

• Xác thực
• Tài liệu tham chiếu API