Chuyển đến nội dung chính
POST
Endpoint này cho phép bạn tải lên một tệp hoặc một hình ảnh hoặc video nhỏ để đưa vào bài đăng của bạn. URL đến hình ảnh sẽ được trả về, có thể được sử dụng trong endpoint /post. Bạn có thể truyền tệp dưới dạng multipart form data như một tham số form hoặc dưới dạng tệp mã hóa Base64 như một tham số body. Lưu ý quan trọng về việc tải lên media:
  1. Để có hiệu suất tốt nhất, chúng tôi khuyến nghị
    • Lưu trữ các tệp media trên máy chủ của riêng bạn (ví dụ AWS S3).
    • Truyền trực tiếp URL media trong tham số mediaUrls của endpoint /post.
    • Cách tiếp cận này nhanh hơn so với việc tải lên tệp thông qua endpoint này.
  2. Lưu giữ tệp media
    • Các tệp đã tải lên được lưu trữ trong 90 ngày.
    • Sau 90 ngày:
      • Các bài đăng đã xuất bản trên mạng xã hội không bị ảnh hưởng.
      • Các bài đăng đã lên lịch sẽ không xuất bản được nếu chúng tham chiếu đến media đã hết hạn.
  3. Giới hạn kích thước tệp
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

Content-Type
string
bắt buộc
Sử dụng multipart/form-data nếu gửi dữ liệu multipart form - xem bên dưới. Nếu không, gửi application/json chuẩn.

Tham số Body

file
string or object
bắt buộc
Kích thước tệp tối đa 30 MB.Chúng tôi khuyến nghị gửi dưới dạng đối tượng multipart form-data thay vì mã hóa Base64.
fileName
string
Tên của tệp sẽ được tải lên.
description
string
Mô tả của tệp.

Gửi dưới dạng Multipart Form-Data

Gửi tệp media dưới dạng đối tượng multipart form-data. Hãy đảm bảo chỉ định Content-Type như đã đề cập ở trên.

Gửi dưới dạng Base64

Gửi tệp media dưới dạng chuỗi được mã hóa Base64 dưới dạng chuỗi Data URI. Chuỗi phải bắt đầu bằng data:content/type;base64 Ví dụ mã hóa với Định dạng Đầu ra Data URI: Lưu ý: Endpoint /post chấp nhận các tệp lớn hơn thông qua URL bên ngoài với tham số mediaUrls.