Skip to main content
POST
Tải tệp đa phương tiện lên
Để đính kèm nội dung đa phương tiện từ URL công khai thay vì tải tệp lên, hãy dùng POST /posts/{post}/media/from-url.

Tham số đường dẫn

string
bắt buộc
UUID của bài đăng cần đính kèm tệp.

Yêu cầu

Gửi dưới dạng multipart/form-data với một trường media.
file
bắt buộc
Tệp cần tải lên, thuộc một trong các loại được phép:
Các loại nội dung đa phương tiện được hỗ trợ:
  • Ảnh: image/jpeg, image/png, image/gif, image/webp - up to 10 MB
  • Video: video/mp4, video/quicktime (MOV) - up to 1 GB

Cách hoạt động

  • Bài đăng phải thuộc không gian làm việc hiện tại của bên gọi; nếu không, API trả về 404.
  • Loại MIME của tệp phải được nền tảng đang bật trong bài đăng hỗ trợ. Ví dụ, tải ảnh lên bài chỉ dùng TikTok sẽ trả về 422, trừ khi bài dùng tiktok_photo.
  • Giới hạn dung lượng theo từng loại được áp dụng sau khi phát hiện MIME. Video lớn hơn 1 GB trả về 422, kể cả khi giới hạn chung của yêu cầu cho phép.
  • Ảnh tĩnh PNG và WebP được chuẩn hóa thành JPEG (q100) khi lưu để tương thích với mọi nền tảng. GIF được giữ nguyên, gồm cả chuyển động trên X, Bluesky và Mastodon. Video MP4 và MOV được lưu nguyên bản.
  • Nội dung mới được lưu tại medias/{uuid}.{ext} trên ổ đã cấu hình (local, s3 hoặc r2) và thêm vào mảng media[] của bài đăng.

Phản hồi

Trả về bài đăng đã cập nhật, có cấu trúc giống GET /posts/{post}, với mục vừa tải lên trong media[]. Nếu xác thực thất bại do loại tệp không được hỗ trợ, tệp quá lớn hoặc không nền tảng đang bật nào chấp nhận, API trả về 422 cùng errors.media[].