Bỏ qua menu, tới nội dung

WanduraDocsBeta

API v1

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.

Tài liệu tham chiếu API

Lấy một creative

Trên trang này

Mô tả
Tham số request
Ví dụ request
Response
Ví dụ response
Lỗi

Trả về bản ghi dữ liệu của một creative đã duyệt thuộc tổ chức của bạn. Dùng endpoint này để lấy một creative, hoặc kiểm tra một creative bạn đã lưu có còn khả dụng không.

GET /api/delivery/v1/creatives/{id}

Scope: creatives:export

Mô tả

Trả về cùng bản ghi như Liệt kê creative, đượ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

Tên	Vị trí	Kiểu	Bắt buộc	Mô tả
`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`.

Ví dụ request

curl -s https://www.wandura.ai/api/delivery/v1/creatives/5e1b7c3a-2d4f-4a6b-9c8d-0e1f2a3b4c5d \
  -H "Authorization: Bearer $WANDURA_API_KEY"

Response

200 OK

Trường	Kiểu	Mô tả
`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.
`server_time`	integer	Giờ server tính bằng giây Unix epoch.

Ví dụ response

{
  "code": 0,
  "message": "ok",
  "data": {
    "schema_version": 1,
    "creative_id": "5e1b7c3a-2d4f-4a6b-9c8d-0e1f2a3b4c5d",
    "creative_code": "ACV001-FILM0001-EP1-2-F1-TEAM",
    "name": "Heiress returns - wedding hook",
    "status": "pushed",
    "created_at": 1790500000,
    "approved_at": 1790590000,
    "updated_at": 1790640000,
    "org": { "slug": "your-org" },
    "film": { "code": "FILM0001", "title": "The Heiress Returns", "language": "en", "genres": ["romance", "revenge"] },
    "episodes": [1, 2],
    "placement": "reels_9x16",
    "aspect": "9:16",
    "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": 2, "start_ms": 40000, "end_ms": 54000, "duration_ms": 14000, "action": null, "line": null }
    ],
    "hook": { "action": "reveal", "line": "You threw me out. Now watch me take it all back." },
    "formula": { "name": "Cliffhanger opener" },
    "rights": { "ends_at": 1798675200 },
    "lineage": { "parent_creative_id": null },
    "final": { "ready": true, "target": { "width": 1080, "height": 1920, "fps": 30, "codec": "h264" } }
  },
  "server_time": 1790679032
}

Lỗi

Status	`code`	Khi nào
401	4010	Thiếu header `Authorization: Bearer`.
401	4011	Key không tồn tại hoặc đã bị thu hồi.
403	4030	Key thiếu scope `creatives:export`.
403	4031	Quyền truy cập của tổ chức bạn đang bị tạm ngưng.
404	4040	Không có creative đã duyệt nào với ID này cho tổ chức của bạn, hoặc ID không phải UUID.
429	không có	Đã chạm rate limit. Body phẳng với `error_code` `rate_limited`, không phải envelope.
503	5030	Feed tạm thời không khả dụng. Retry với backoff.
503	5031	Wandura chưa kiểm được API key kịp thời. Key không sai: retry với backoff.

Xem Lỗi để biết cách xử lý từng trường hợp.

Cập nhật 01/10/2026 · Lịch sử thay đổi (2)