Skip to main content
POST
Đính kèm nội dung đa phương tiện từ URL
Để tải tệp trực tiếp từ máy thay vì lấy qua URL, hãy dùng POST /posts/{post}/media.

Tham số đường dẫn

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

Yêu cầu

array
bắt buộc
URL HTTP/HTTPS công khai của ảnh hoặc video. Tối đa 10 URL mỗi lần gọi. Giới hạn dung lượng là 10 MB cho ảnh và 1 GB cho video.Các loại MIME hợp lệ:
  • Ảnh: image/jpeg, image/png, image/gif, image/webp
  • Video: video/mp4, video/quicktime (MOV)
Máy chủ tải nội dung từ URL và lưu thành bản ghi Media trong không gian làm việc.

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.
  • Hệ thống chỉ chấp nhận các loại nội dung đa phương tiện vừa hợp lệ, vừa được các nền tảng đang bật trong bài đăng hỗ trợ. Nếu một nền tảng không hỗ trợ loại tệp đó, tệp sẽ bị từ chối và đưa vào failed_urls.
  • Tệp đính kèm thành công được thêm vào mảng media[] của bài đăng.

Phản hồi

Trả về một đối tượng gồm ba trường:
object
Bài đăng đã cập nhật, có cấu trúc giống GET /posts/{post} , với các mục vừa đính kèm trong mảng media[].
integer
Số URL đã được tải xuống và đính kèm thành công.
array
Các URL bị từ chối do không truy cập được, sai loại MIME, quá lớn hoặc không được nền tảng đang bật nào hỗ trợ. Mỗi mục là chuỗi URL ban đầu.