Chuyển đến nội dung chính
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.
  • 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.
Nếu bạn đã có media có thể truy cập bằng URL bên ngoài, chẳng hạn như một S3 bucket, bạn có thể bỏ qua việc tải các tệp lên Ayrshare. Chỉ cần POST đến endpoint /post với URL có thể truy cập từ bên ngoài của bạn trong tham số body mediaURLs và tệp của bạn sẽ tự động được tải lên.

Tham số Header

Tham số Query

fileName
string
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.
contentType
string
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

  • accessUrl là URL để truy cập tệp media sau khi tải lên.
  • contentType là 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.
  • uploadUrl là 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 uploadURLaccessURL thô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-file với một tệp media và uploadUrl.
  • Khi tải lên thành công, một phản hồi 200 sẽ được trả về.
  • Sau khi tải lên tệp media, POST đến endpoint /post với accessUrl trong tham số body mediaUrls.
  • 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.
Hãy đảm bảo rằng 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 đến uploadUrl. Trong Postman:
  1. Chọn HTTP Method PUT.
  2. Dán uploadUrl củ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ại uploadUrl.
  3. Trong Headers đặt Content-Type thành content type được trả về trong endpoint /uploadUrl. Ví dụ: Content-Type: image/png.
  4. Chọn Body -> binary và chọn tệp để tải lên.
  5. Nhấn Send.
  6. 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.
Postman Binary Upload

Postman Sample JSON File