Lịch sử: Lấy một creative

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 · +2 −1 dòng

Xem thay đổi

⋯
  | `Wandura-API-Status` | mọi response | Trạng thái API. Hiện là `beta`, ở mọi response, thành công hay lỗi. |
  | `Wandura-Version` | mọi response | Phiên bản API theo ngày (YYYY-MM-DD) mà response này dùng: bản ghim vào API key của bạn, hoặc bản bạn gửi trong header request `Wandura-Version`. Key tạo trước khi có phiên bản ngày dùng `2026-10-02`. |
+ | `Wandura-Request-Id` | mọi response | Mã định danh mờ của request này (`req_` và 26 ký tự). Mọi response đều có, kể cả lỗi, và body lỗi lặp lại nó ở `request_id`. Hãy ghi log nó, và gửi kèm khi liên hệ Wandura về một request: nó tìm đúng request đó trong log của chúng tôi. Đừng phân tích chuỗi này. |
  | `Deprecation` | 200 | Chỉ có khi endpoint này, hoặc phiên bản ngày đang phục vụ response, đã bị ngừng hỗ trợ (RFC 9745): `@<giây unix>` của ngày ngừng. Hãy ghi nó vào hệ giám sát. |
  | `Sunset` | 200 | Chỉ có khi endpoint hay phiên bản ngày đã bị ngừng có ngày thôi chạy (RFC 8594), dạng ngày HTTP. |
  | `Link` | 200 | Có kèm `Deprecation`: `<https://docs.wandura.ai/…>; rel="deprecation"` (và `rel="sunset"`) trỏ tới trang giải thích dùng gì thay thế. |
- | `Cache-Control` | 200, 401, 403, 404, 503 | Luôn là `no-store`. Đừng lưu các response này trong cache dùng chung. |
+ | `Cache-Control` | mọi response | Luôn là `no-store`. Đừng lưu các response này trong cache dùng chung. |
  | `Retry-After` | 429 | Số giây cần chờ trước khi thử lại. Có ở response 429 và các response 503 nên thử lại. |
  | `X-RateLimit-Limit` | 429 | Số request (với playback là số vé) được phép trong một cửa sổ cho nhóm endpoint này và tổ chức của bạn. |
⋯

02/10/2026 · +6 −6 dòng

Xem thay đổi

⋯
  **Scope:** `creatives:export`
  
- ## Mô tả
+ ## Mô tả {#description}
  
  Trả về cùng bản ghi như [Liệt kê creative](creatives-list.md#the-creative-record), được bọc trong envelope `{code, message, data, server_time}`. Creative không tồn tại, thuộc tổ chức khác, hoặc không ở status `approved` hay `pushed` đều trả về cùng một `404`, nên bạn không phân biệt được các trường hợp này.
  
- ## Tham số request
+ ## Tham số request {#request-parameters}
  
  | Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
⋯
  | `Wandura-Version` | header | string | Không | Tuỳ chọn. Một phiên bản API theo ngày (YYYY-MM-DD) dùng cho request này thay cho bản ghim vào API key của bạn. Giá trị lạ hoặc đã ngừng trả 400 với `error_code` `unsupported_version`. |
  
- ## Ví dụ request
+ ## Ví dụ request {#request-example}
  
  ```bash
⋯
  ```
  
- ## Response
+ ## Response {#response}
  
  `200 OK`
⋯
  | `links` | object | URL tuyệt đối dựng sẵn của response này. |
  
- ## Ví dụ response
+ ## Ví dụ response {#response-example}
  
  ```json
⋯
  | `X-RateLimit-Window` | 429 | Độ dài cửa sổ tính bằng giây. |
  
- ## Lỗi
+ ## Lỗi {#errors}
  
  | Status | `code` | Khi nào |
⋯

02/10/2026 · +7 −0 dòng

Xem thay đổi

⋯
  | `Authorization` | header | string | Có | `Bearer <API key>` của một key có scope `creatives:export`. |
  | `id` | path | string | Có | `creative_id` của creative. Giá trị không phải UUID sẽ trả 404. |
+ | `Wandura-Version` | header | string | Không | Tuỳ chọn. Một phiên bản API theo ngày (YYYY-MM-DD) dùng cho request này thay cho bản ghim vào API key của bạn. Giá trị lạ hoặc đã ngừng trả 400 với `error_code` `unsupported_version`. |
  
  ## Ví dụ request
⋯
  | `data` | object | Bản ghi dữ liệu của một creative đã duyệt. Không bao giờ chứa URL media. |
  | `server_time` | integer | Giờ server tính bằng giây Unix epoch. |
+ | `links` | object | URL tuyệt đối dựng sẵn của response này. |
  
  ## Ví dụ response
⋯
  |---|---|---|
  | `Wandura-API-Status` | mọi response | Trạng thái API. Hiện là `beta`, ở mọi response, thành công hay lỗi. |
+ | `Wandura-Version` | mọi response | Phiên bản API theo ngày (YYYY-MM-DD) mà response này dùng: bản ghim vào API key của bạn, hoặc bản bạn gửi trong header request `Wandura-Version`. Key tạo trước khi có phiên bản ngày dùng `2026-10-02`. |
+ | `Deprecation` | 200 | Chỉ có khi endpoint này, hoặc phiên bản ngày đang phục vụ response, đã bị ngừng hỗ trợ (RFC 9745): `@<giây unix>` của ngày ngừng. Hãy ghi nó vào hệ giám sát. |
+ | `Sunset` | 200 | Chỉ có khi endpoint hay phiên bản ngày đã bị ngừng có ngày thôi chạy (RFC 8594), dạng ngày HTTP. |
+ | `Link` | 200 | Có kèm `Deprecation`: `<https://docs.wandura.ai/…>; rel="deprecation"` (và `rel="sunset"`) trỏ tới trang giải thích dùng gì thay thế. |
  | `Cache-Control` | 200, 401, 403, 404, 503 | Luôn là `no-store`. Đừng lưu các response này trong cache dùng chung. |
  | `Retry-After` | 429 | Số giây cần chờ trước khi thử lại. Có ở response 429 và các response 503 nên thử lại. |
⋯
  | Status | `code` | Khi nào |
  |---|---|---|
+ | 400 | không có | Header `Wandura-Version`, hoặc bản ghim của key, là bản lạ hay đã ngừng. Body có thêm `supported_versions` và `latest_version` (và `upgrade_to` khi bản ghim đã ngừng). |
  | 401 | 4010 | Thiếu header `Authorization: Bearer`. |
  | 401 | 4011 | Key không tồn tại hoặc đã bị thu hồi. |
⋯

02/10/2026 · +20 −3 dòng

Xem thay đổi

⋯
  |---|---|---|---|---|
  | `Authorization` | header | string | Có | `Bearer <API key>` của một key có scope `creatives:export`. |
- | `id` | path | string (UUID) | Có | `creative_id` của creative. Giá trị không phải UUID sẽ trả `404`. |
+ | `id` | path | string | Có | `creative_id` của creative. Giá trị không phải UUID sẽ trả 404. |
  
  ## Ví dụ request
⋯
  | `code` | integer | `0`. |
  | `message` | string | `"ok"`. |
- | `data` | object | Bản ghi creative. Các trường được liệt kê trong [Bản ghi creative](creatives-list.md#the-creative-record). |
+ | `data` | object | Bản ghi dữ liệu của một creative đã duyệt. Không bao giờ chứa URL media. |
  | `server_time` | integer | Giờ server tính bằng giây Unix epoch. |
  
⋯
      "duration_ms": 21500,
      "scenes": [
-       { "episode_no": 1, "start_ms": 12000, "end_ms": 19500, "duration_ms": 7500, "action": "reveal", "line": "You threw me out. Now watch me take it all back." },
+       {
+         "episode_no": 1,
+         "start_ms": 12000,
+         "end_ms": 19500,
+         "duration_ms": 7500,
+         "action": "reveal",
+         "line": "You threw me out. Now watch me take it all back."
+       },
        { "episode_no": 2, "start_ms": 40000, "end_ms": 54000, "duration_ms": 14000, "action": null, "line": null }
      ],
⋯
  ```
  
+ ## Header của response {#response-headers}
+ 
+ | Header | Response | Mô tả |
+ |---|---|---|
+ | `Wandura-API-Status` | mọi response | Trạng thái API. Hiện là `beta`, ở mọi response, thành công hay lỗi. |
+ | `Cache-Control` | 200, 401, 403, 404, 503 | Luôn là `no-store`. Đừng lưu các response này trong cache dùng chung. |
+ | `Retry-After` | 429 | Số giây cần chờ trước khi thử lại. Có ở response 429 và các response 503 nên thử lại. |
+ | `X-RateLimit-Limit` | 429 | Số request (với playback là số vé) được phép trong một cửa sổ cho nhóm endpoint này và tổ chức của bạn. |
+ | `X-RateLimit-Window` | 429 | Độ dài cửa sổ tính bằng giây. |
+ 
  ## Lỗi
  
⋯

02/10/2026 · Tạo trang