Media
Tải lên Tệp Media Lớn
Đối với việc tải lên tệp lớn hơn 10 MB, lấy một URL đã được ký sẵn để tải lên tệp
GET
Đối với việc tải lên tệp lớn hơn 10 MB, lấy một URL đã được ký sẵn (presigned URL) để tải lên tệp.
Hãy đảm bảo rằng

- Kích thước tải lên tệp tối đa 5 GB.
- URL tải lên đã được ký sẵn có hiệu lực trong 30 phút sau khi được tạo.
- URL truy cập khả dụng trong 30 ngày sau khi tải lên. Tất cả các bài đăng đã xuất bản đều không bị ảnh hưởng trên các mạng xã hội. Các bài đăng đã lên lịch vượt quá khung thời gian đó sẽ dẫn đến lỗi vào lúc xuất bản.
Tham số Header
Tham số Query
Nếu contentType không có mặt, thì tên tệp đầy đủ với phần mở rộng là bắt buộc.Tên của tệp sẽ được tải lên. Phải bao gồm phần mở rộng như .png, .jpg, .mov, .mp4, v.v.
Content-type của media đang được tải lên. Các định dạng hợp lệ bao gồm:
mp4, mov, png, jpg, hoặc jpeg.Ví dụ, nếu tệp là một tệp Quicktime .mov, thì contentType phải là mov.Nếu không có mặt, application/octet-stream sẽ được sử dụng.Chi tiết Phản hồi
accessUrllà URL để truy cập tệp media sau khi tải lên.contentTypelà content-type được đặt cho media đang được tải lên. Sử dụng giá trị này trong header Content-Type khi tải lên media.uploadUrllà URL được sử dụng để PUT tệp media. Xem bên dưới.
Các Ví dụ Endpoint Bổ sung
Quy trình để tải lên các tệp lớn hơn:- Lấy
uploadURLvàaccessURLthông qua endpoint/media/uploadUrl. Xem ở trên. - Tải lên tệp thông qua một PUT với Content-Type được đặt thành
contentTypeđã trả về. - Tải lên media bằng cách sử dụng
--upload-filevới một tệp media vàuploadUrl. - Khi tải lên thành công, một phản hồi
200sẽ được trả về. - Sau khi tải lên tệp media, POST đến endpoint
/postvớiaccessUrltrong tham số bodymediaUrls. - URL tải lên đã được ký sẵn chỉ có thể được tải lên một lần. Nếu bạn gửi một tệp không hợp lệ, bạn phải tạo một URL tải lên mới. Sẽ không có phản hồi lỗi nếu tệp không được tải lên thành công. Xem bên dưới về xác minh URL tồn tại.
contentType được đặt khi tạo uploadUrl khớp với Content-Type và loại tệp khi PUT tệp.
Ví dụ, nếu bạn đặt contentType thành “image/png” khi tạo uploadUrl, hãy đảm bảo đặt Content-Type: image/png và tệp được tải lên kết thúc bằng .png.
Khi tải lên thành công, một phản hồi 200 sẽ được trả về.
Ví dụ Tải lên Tệp Nhị phân trong Node.js
Đây là một ví dụ về việc tải lên tệp media nhị phân sử dụng Node với JavaScript:Ví dụ Tải lên Tệp Nhị phân trong Postman
Bạn cũng có thể sử dụng Postman để tải lên tệp nhị phân đếnuploadUrl.
Trong Postman:
- Chọn HTTP Method
PUT. - Dán
uploadUrlcủa bạn vào trường url. Lưu ý, url sẽ hết hạn sau một giờ và chỉ có thể được sử dụng một lần. Nếu bạn thực hiện một cuộc gọi và nó thất bại, bạn phải tạo lạiuploadUrl. - Trong Headers đặt
Content-Typethành content type được trả về trong endpoint /uploadUrl. Ví dụ:Content-Type: image/png. - Chọn Body -> binary và chọn tệp để tải lên.
- Nhấn Send.
- Quan trọng: Sẽ không có phản hồi trả về, vì vậy bạn nên kiểm tra xem việc tải lên có thành công hay không bằng cách mở
accessUrlđược trả về từ endpoint /uploadUrl trong trình duyệt. Bạn cũng có thể sử dụng endpoint xác minh URL.

