Test

TL;DR — Không có sandbox: test gọi https://www.wandura.ai. Giữ lưu lượng test trong tổ chức test của bạn (chỉ phim mẫu, lượt phát không bao giờ được tính) và tạo bất kỳ lỗi nào khi cần bằng header Wandura-Simulate. Chạy CI của bạn với một mock dựng từ tệp OpenAPI. Không bao giờ load-test production. Sau đó chạy test plan bên dưới trên điện thoại thật.

Test ở đâu#

Tổ chức test#

Mỗi đối tác có một tổ chức test bên cạnh tổ chức production. Wandura tạo nó khi bạn đề nghị trong kênh Discord của team và thêm Admin, Developer của bạn vào. Trên partner.wandura.ai, chuyển sang "Tổ chức của bạn (test)" rồi tạo key ở Developers như thường lệ. Các ví dụ trên trang này gọi key đó là WANDURA_TEST_KEY.

Key test gọi đúng URL production, https://www.wandura.ai, và chạy y như key production, chỉ khác ba điểm:

1. Không được tính. Lượt phát của nó không bao giờ được tính là lượt xem, usage hay doanh thu.
2. Chỉ phim mẫu. Nó chỉ phát được hai phim mẫu của Wandura là ninety-days và the-fire-clause (tập ngắn, có phụ đề tiếng Anh). Tổ chức test không có video mở.
3. Giả lập lỗi. Nó được gửi header Wandura-Simulate (bên dưới). Key production bỏ qua hoàn toàn header này.

GET /config cho biết bạn đang cầm loại key nào:

{
  "key": { "scopes": ["metadata:read", "playback"], "test_organisation": true }
}

Trạng thái thật, khi bạn đề nghị. Với những gì giả lập không cho thấy được (ví dụ một key thật sự ngừng chạy, hay một giấy phép thật sự kết thúc), hãy hỏi trong kênh của bạn: Wandura có thể treo tổ chức test, treo hoặc kết thúc giấy phép của một phim mẫu, tắt streaming, hoặc hạ rate limit playback để bạn test 429 thật. Thay đổi có hiệu lực trong vòng 30 giây. Rate limit playback của tổ chức test là 600 vé mỗi phút.

Lỗi giả lập#

Với key test, gửi Wandura-Simulate: <scenario>. Bạn nhận đúng status, body và header như lỗi thật, kèm Wandura-Simulated: <scenario> trên response. Câu trả lời giả lập không cấp vé và không tính vào rate limit; bản thân các câu trả lời giả lập bị giới hạn 300 lượt mỗi phút cho mỗi tổ chức. Bước kiểm key, scope và phiên bản vẫn chạy trước, nên một key sai vẫn nhận 401. Nếu response không có header Wandura-Simulated, nghĩa là không có gì được giả lập (tên lạ, hoặc kịch bản không áp dụng cho endpoint đó) và request đã chạy bình thường.

Trong một lô, kịch bản theo từng tập trả 200 { "items": [...] } với lỗi trên từng phần tử, y như một lô thật.

Không giả lập được: giấy phép Player SDK hết hạn (nó nằm trên thiết bị).

Ví dụ: rate_limited#

curl -s -i https://www.wandura.ai/api/delivery/v1/catalog \
  -H "Authorization: Bearer $WANDURA_TEST_KEY" \
  -H "Wandura-Simulate: rate_limited"

HTTP/2 429
retry-after: 1
x-ratelimit-limit: 600
x-ratelimit-window: 60
wandura-simulated: rate_limited

{
  "error": "Too many catalog requests for this account. This is an abuse ceiling, not a quota — if a normal integration reaches it, contact us and it will be raised.",
  "error_code": "rate_limited"
}

Ví dụ: not_entitled:outside_window#

Không cần giá trị thiết bị: không có gì được cấp.

curl -s https://www.wandura.ai/api/delivery/v1/playback \
  -H "Authorization: Bearer $WANDURA_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Wandura-Simulate: not_entitled:outside_window" \
  -d '{ "film_ref": "ninety-days", "episode_no": 1, "intent": "play" }'

{
  "error": "outside_window",
  "error_code": "not_entitled",
  "reason": "outside_window"
}

Ví dụ: partial_batch#

Phần tử 0 là vé thật, nên hãy gửi giá trị thiết bị của một máy thật (xem Bắt đầu nhanh · Phần B).

curl -s https://www.wandura.ai/api/delivery/v1/playback \
  -H "Authorization: Bearer $WANDURA_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Wandura-Simulate: partial_batch" \
  -d '{ "film_ref": "ninety-days", "episode_no": 1, "next": 2, "intent": "play",
        "union_info": "'"$UNION_INFO"'", "drm_kek": "'"$DRM_KEK"'", "viewer_ref": "qa-viewer-1:device-1" }'

{
  "items": [
    { "request": { "film_ref": "ninety-days", "episode_no": 1 }, "status": 200, "vid": "v0d2f8c1a9e4b7", "play_auth_token": "placeholder-play-token", "expires_at": "2026-10-02T12:30:00.000Z", "protection": "private-encrypted", "subtitles": [] },
    { "request": { "film_ref": "ninety-days", "episode_no": 2 }, "status": 503, "error": "The video provider did not answer in time — retry", "error_code": "service_unavailable", "retry_after": 2 },
    { "request": { "film_ref": "ninety-days", "episode_no": 3 }, "status": 429, "error": "Prefetch requests are paused while your playback traffic is close to its ceiling — tickets for viewers who pressed play are still issued. Retry the prefetch after Retry-After, or request it when the viewer plays.", "error_code": "rate_limited", "reason": "prefetch_shed", "retry_after": 1 }
  ]
}

Những gì bạn tái hiện được với key bất kỳ#

Load test#

Đừng load-test production. Để test hệ thống của chính bạn khi tải cao, hãy mock Wandura. Để test cách xử lý 429 với Wandura, dùng Wandura-Simulate: rate_limited, hoặc đề nghị hạ rate limit cho tổ chức test của bạn.

Test plan#

Chạy trên bản build release, trên một iPhone thật và một điện thoại Android thật.

Key và bảo mật

• Không có wnd_live_ trong các app đã build.
• Không có key đầy đủ, play_auth_token hay giá trị thiết bị thô trong log của bạn (Quan sát hệ thống).
• Catalog không có key: 401; với key thiếu metadata:read: 403. Job của bạn cảnh báo và giữ nguyên bản sao.

Catalog

• Các phim hiển thị khớp với giấy phép Wandura đã xác nhận, theo thứ tự của API.
• Tập miễn phí mở được mà không phải trả tiền; tập kế tiếp hiện paywall của bạn.
• Tập giữ chỗ hiện "sắp ra mắt" và không chạm được; tập stream_ready: false bị làm mờ.
• Khi chặn mạng của sync job trong một lần chạy, catalog trong app không đổi.

Playback

• Tập miễn phí phát được, có phụ đề; đổi ngôn ngữ hoạt động; tập không có phụ đề vẫn phát.
• Tập bị khoá hiện paywall của bạn và không tạo request nào tới Wandura.
• Bắt đầu một tập gửi một request (play + các prefetch đã mở khoá); chuyển sang tập kế thì phát ngay và gửi một play mới.
• Tạm dừng hơn 30 phút rồi phát tiếp dẫn tới đúng một vé mới và phát lại từ cùng vị trí.
• Bật chế độ máy bay giữa tập rồi tắt: phục hồi mà không crash.
• 429, 503, 500, not_entitled, not_ready và partial_batch, giả lập bằng Wandura-Simulate, đều hiện đúng màn hình.

Bản quyền kết thúc

• Nhờ Wandura kết thúc giấy phép của một phim mẫu trong tổ chức test của bạn. Sau hai lần đồng bộ kế tiếp, phim bị ẩn, và request xin vé trả 403 not_entitled.

Liên quan#

• Checklist go-live
• Lỗi