Bản lưu ngày / Snapshot of 2026-10-01 · 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ử: Rate limit

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

← Rate limit

  1. 01/10/2026 · +7 −4 dòng
    Xem thay đổi
    ⋯
      
      - **Theo tổ chức.** Request được đếm chung cho cả tổ chức, không theo từng key. Tạo thêm key không nâng ngưỡng của bạn.
    - - **Theo nhóm endpoint.** Playback có bộ đếm riêng. Endpoint catalog và creatives dùng chung bộ đếm thứ hai.
    + - **Theo nhóm endpoint.** Playback, catalog và creatives mỗi nhóm có bộ đếm riêng, nên một vòng đồng bộ creatives chạy mất kiểm soát không chặn được catalog của bạn.
      - **Cửa sổ cố định.** Bộ đếm reset khi mỗi cửa sổ thời gian bắt đầu.
      - **Chỉ request đã xác thực.** Request thiếu key hoặc key không hợp lệ bị từ chối trước khi được đếm, nên không ai khác làm cạn ngưỡng của bạn được.
    ⋯
      | Nhóm endpoint | Ngưỡng mỗi tổ chức | Cửa sổ |
      |---|---|---|
    - | Playback: `POST /api/delivery/v1/playback` | 30.000 request | 60 giây |
    - | Catalog và creatives, chung một bộ đếm: `GET /api/delivery/v1/catalog`, `GET /api/delivery/v1/creatives`, `GET /api/delivery/v1/creatives/{id}` | 3.000 request | 60 giây |
    + | Playback: `POST /api/delivery/v1/playback` | 10.800 request (khoảng 180 vé mỗi giây) | 60 giây |
    + | Catalog: `GET /api/delivery/v1/catalog` | 3.000 request | 60 giây |
    + | Creatives: `GET /api/delivery/v1/creatives`, `GET /api/delivery/v1/creatives/{id}` (một bộ đếm cho cả hai) | 3.000 request | 60 giây |
      
    - Mỗi cửa sổ là một phút đồng hồ (UTC), nên bộ đếm bắt đầu lại ở mỗi phút tròn. Wandura nâng được ngưỡng cho tổ chức của bạn khi bạn yêu cầu: hỏi trong kênh Discord Wandura của team bạn. Trên response `429`, header `X-RateLimit-Limit` cho biết ngưỡng đang áp cho bạn.
    + Mỗi cửa sổ là một phút đồng hồ (UTC), nên bộ đếm bắt đầu lại ở mỗi phút tròn. Một người xem bắt đầu một tập thường tốn khoảng ba vé playback (chính tập đó cộng các vé xin trước), nên ngưỡng playback tương đương khoảng 60 người bắt đầu xem mỗi giây.
      
    + Wandura nâng được bất kỳ ngưỡng nào ở trên riêng cho tổ chức của bạn: hỏi trong kênh Discord Wandura của team bạn. Ngưỡng mới có hiệu lực trong khoảng một phút, bạn không phải đổi gì. Wandura cũng nhận cảnh báo khi một tổ chức chạm ngưỡng playback. Trên response `429`, header `X-RateLimit-Limit` cho biết ngưỡng đang áp cho bạn.
    + 
      ## Khi bạn chạm ngưỡng
      
    ⋯
  2. 01/10/2026 · +10 −1 dòng
    Xem thay đổi
    ⋯
      Mọi request xin vé đều tính vào ngưỡng playback, kể cả request có `"intent": "prefetch"`.
      
    + ## Ngưỡng hiện tại {#limits}
    + 
    + | Nhóm endpoint | Ngưỡng mỗi tổ chức | Cửa sổ |
    + |---|---|---|
    + | Playback: `POST /api/delivery/v1/playback` | 30.000 request | 60 giây |
    + | Catalog và creatives, chung một bộ đếm: `GET /api/delivery/v1/catalog`, `GET /api/delivery/v1/creatives`, `GET /api/delivery/v1/creatives/{id}` | 3.000 request | 60 giây |
    + 
    + Mỗi cửa sổ là một phút đồng hồ (UTC), nên bộ đếm bắt đầu lại ở mỗi phút tròn. Wandura nâng được ngưỡng cho tổ chức của bạn khi bạn yêu cầu: hỏi trong kênh Discord Wandura của team bạn. Trên response `429`, header `X-RateLimit-Limit` cho biết ngưỡng đang áp cho bạn.
    + 
      ## Khi bạn chạm ngưỡng
      
    ⋯
      1. Ngừng gửi request tới nhóm endpoint đó cho đến khi hết `Retry-After`. Retry sớm hơn chỉ nhận thêm `429`.
      2. Tìm nguyên nhân: vòng lặp retry không có backoff, job xin vé cho cả catalog, hoặc gọi catalog mỗi lần mở app thay vì dùng cache phía server.
    - 3. Nếu lưu lượng bình thường của bạn chạm ngưỡng, hãy liên hệ Wandura để được nâng ngưỡng.
    + 3. Nếu lưu lượng bình thường của bạn chạm ngưỡng, hãy hỏi trong kênh Discord Wandura của team bạn để được nâng ngưỡng.
      
      ## Thói quen tốt
    ⋯
  3. 01/10/2026 · +1 −1 dòng
    Xem thay đổi
    ⋯
      1. Ngừng gửi request tới nhóm endpoint đó cho đến khi hết `Retry-After`. Retry sớm hơn chỉ nhận thêm `429`.
      2. Tìm nguyên nhân: vòng lặp retry không có backoff, job xin vé cho cả catalog, hoặc gọi catalog mỗi lần mở app thay vì dùng cache phía server.
    - 3. Nếu lưu lượng bình thường của bạn chạm ngưỡng, hãy liên hệ đầu mối đối tác Wandura để được nâng ngưỡng.
    + 3. Nếu lưu lượng bình thường của bạn chạm ngưỡng, hãy liên hệ Wandura để được nâng ngưỡng.
      
      ## Thói quen tốt
    ⋯
  4. 29/09/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