Bản lưu ngày / Snapshot of 2026-10-18 · 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.
Lịch sử thay đổi

Lịch sử: Hành vi chuẩn của API

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

← Hành vi chuẩn của API

  1. 02/10/2026 · +4 −8 dòng
    Xem thay đổi
    ⋯
      | Phim hoặc tập được publish hay bị rút, `stream_ready` thay đổi | Catalog: ≤ 30 giây | ≤ 60 giây |
      | Giấy phép được cấp, tạm ngưng, tắt hoặc ra ngoài khung thời gian | Catalog: ≤ 30 giây | ≤ 30 giây |
    - | Tổ chức bị tạm ngưng | ≤ 30 giây | ≤ 30 giây |
    - | Key bị thu hồi hoặc xoay vòng | ≤ 30 giây (creatives: ngay lập tức) | ≤ 30 giây |
    + | Tổ chức bị tạm ngưng | khoảng 1 giây (luôn ≤ 30 giây) | khoảng 1 giây (luôn ≤ 30 giây) |
    + | Key bị thu hồi hoặc xoay vòng | khoảng 1 giây (luôn ≤ 30 giây) | khoảng 1 giây (luôn ≤ 30 giây) |
      | Thứ vừa được tạo (một key, một tập, một giấy phép) | ≤ 5 giây | ≤ 5 giây |
      | Phụ đề được gắn hoặc thay | — | ≤ 5 phút |
    ⋯
      | Ngôn ngữ phụ đề trong `GET /config` | ≤ 5 phút | — |
      
    - > **Đang triển khai.** Key đã thu hồi, hoặc secret cũ của một key đã xoay vòng, bị từ chối trong khoảng **1 giây** trên mọi server của Wandura (luôn trong vòng 30 giây).
    - 
      - **Nhiều server.** Mỗi server của Wandura giữ cache riêng, nên hai lệnh gọi cách nhau vài giây có thể trả về ảnh chụp hơi khác nhau. Điều đó là bình thường.
      - **Khi cơ sở dữ liệu của Wandura gặp sự cố**, việc kiểm tra catalog và giấy phép được phục vụ từ câu trả lời tốt gần nhất trong tối đa **5 phút** (stale-if-error), thay vì báo lỗi. Một thay đổi Wandura đã thấy (rút phim, tạm ngưng) không bao giờ bị hoàn tác vì cơ chế này.
    ⋯
      - `Retry-After` đi kèm `429` và các `503` nên retry.
      
    - > **Đang triển khai.** Mọi response đều mang header `Wandura-Request-Id`, và mọi body lỗi đều có trường `request_id`. Hãy dẫn nó khi liên hệ hỗ trợ.
    + - Mọi response đều mang header `Wandura-Request-Id`, và mọi body lỗi JSON đều có trường `request_id`. Hãy dẫn nó khi liên hệ hỗ trợ.
      
      Mọi status và mã lỗi, theo từng endpoint, kèm cách xử lý: [Lỗi](../concepts/errors.md).
    ⋯
      ## Header về caching {#caching-headers}
      
    - Response của creatives và cấu hình mang `Cache-Control: no-store`. Không bao giờ lưu bất kỳ response nào của Delivery API trong cache dùng chung (CDN hay proxy): vé, link đã ký và catalog của bạn chỉ thuộc về tổ chức của bạn.
    - 
    - > **Đang triển khai.** Mọi response của Delivery API, kể cả vé, đều mang `Cache-Control: no-store`.
    + Mọi response của Delivery API, kể cả vé, đều mang `Cache-Control: no-store` và không đặt cookie nào. Không bao giờ lưu chúng trong cache dùng chung (CDN hay proxy): vé, link đã ký và catalog của bạn chỉ thuộc về tổ chức của bạn.
      
      ## Liên quan {#related}
    ⋯
  2. 02/10/2026 · Tạo trang
↑↓ 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