Tải file cuối của một creative

Chuyển hướng tới link tải video cuối của một creative đã duyệt thuộc tổ chức của bạn. Dùng endpoint này để tự động lấy file khi bản ghi của creative báo final.ready là true.

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

Scope: creatives:export

Mô tả#

Tải cùng file với final.file_url của bản ghi, nhưng bằng API key thay cho link chia sẻ công khai: dùng khi bạn không muốn dựa vào link chia sẻ. URL https://www.wandura.ai/api/delivery/v1/creatives/{id}/file không hết hạn. Gọi bằng API key của bạn; nó trả 302 kèm link tải trong Location, dùng được 15 phút. File là bản cuối sạch, có brand mark của công ty bạn nếu tổ chức bạn có: MP4, 1080 × 1920.

• Link tải không cần key và không được cache. Đừng lưu link này: gọi lại endpoint để lấy link mới.
• Phần lớn HTTP client tự đi theo chuyển hướng và bỏ header Authorization trên đường đi, không sao.
• Thêm redirect=0 để nhận link và hạn dùng dạng JSON thay vì chuyển hướng.
• Creative không tồn tại, thuộc tổ chức khác, hoặc không ở status approved hay pushed đều trả cùng một 404. Creative đã duyệt mà bản cuối chưa sẵn sàng trả 409. Khi quyền xuất của bạn với phim đã hết, endpoint trả 403 với code 4032.
• Mỗi lần gọi đều được ghi nhật ký theo API key của bạn và dùng chung bộ đếm rate limit với các endpoint creatives khác.

Tham số request#

Ví dụ request#

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

Response#

302 Found: link tải nằm trong header Location. Body rỗng.

200 OK (chỉ khi có redirect=0):

Ví dụ response#

{
  "code": 0,
  "message": "ok",
  "data": { "url": "https://media.example.com/final.mp4?signature=7f3a9c", "expires_at": 1790679932 },
  "server_time": 1790679032
}

Header của response#

Lỗi#

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