Chuyển đến nội dung chính
POST
Xuất bản bài đăng đến các mạng xã hội mà bạn hoặc người dùng của bạn đã liên kết. Nếu bạn muốn xuất bản bài đăng đến các User Profile, vui lòng xem endpoint /profiles để biết thêm chi tiết. Vui lòng đảm bảo thêm API_KEY của bạn, và PROFILE_KEY nếu xuất bản đến một User Profile, trong header Authorization. API Key có thể được tìm thấy trong Ayrshare Developer Dashboard tại trang API Key. Xem Tổng quan Post API để biết thêm chi tiết về các tùy chọn đăng bài.

Tham số Header

Tham số Body

post
string
bắt buộc
Nội dung bài đăng được gửi đến các mạng xã hội được chỉ định trong tham số platforms. Xem tại đây để biết các tùy chọn nâng cao, bao gồm cách bao gồm URL và văn bản phong phú.Bạn có thể gửi một chuỗi rỗng "" để xuất bản mà không có văn bản.
platforms
array
bắt buộc
Các nền tảng mạng xã hội để đăng bài. Chấp nhận một mảng String với các giá trị: bluesky, facebook, gmb, instagram, linkedin, pinterest, reddit, snapchat, telegram, threads, tiktok, twitter, hoặc youtube.Lưu ý: sử dụng facebook cho Facebook Pages, và gmb cho Google Business Profile.Sử dụng all để đăng đến tất cả các mạng xã hội được liên kết. Cũng bao gồm các trường bắt buộc cho tất cả các mạng xã hội. Ví dụ: title phải được bao gồm trong youTubeOptions nếu youtube được liên kết.
mediaUrls
array
Một mảng URL hình ảnh hoặc video để bao gồm trong bài đăng. Vui lòng xem endpoint /media để tìm hiểu thêm.URL phải an toàn và bắt đầu bằng https://. Nếu URL có các ký tự đặc biệt, ví dụ ñ, vui lòng mã hóa các ký tự đặc biệt trước khi gửi.Video yêu cầu gói trả phí.Vui lòng xem tại đây để biết Yêu cầu về hình ảnh và videocác tùy chọn nâng cao khác.
isVideo
boolean
mặc định:false
Ayrshare sẽ cố gắng xác định loại phương tiện dựa trên phần mở rộng file trong URL (.mp4). Bạn có thể đặt phương tiện là video rõ ràng nếu URL không kết thúc bằng phần mở rộng video đã biết, chẳng hạn như GIF động.Vui lòng xem phần mở rộng video để biết chi tiết.
scheduleDate
string
Datetime để lên lịch bài đăng trong tương lai. Chấp nhận thời gian UTC.Ví dụ, sử dụng định dạng YYYY-MM-DDThh:mm:ssZ và gửi dưới dạng 2026-07-08T12:30:00Z. Vui lòng xem utctime để biết thêm ví dụ.Cũng xem lên lịch bài đăng để biết chi tiết.
validateScheduled
boolean
mặc định:true
Theo mặc định, các bài đăng đã lên lịch được kiểm tra (pre-validated) cho các vấn đề như yêu cầu phương tiện trước khi chúng được chấp nhận. Nếu có bất kỳ vấn đề nào được phát hiện bởi các kiểm tra Ayrshare, bạn sẽ nhận được phản hồi lỗi ngay lập tức và bài đăng sẽ không được lên lịch. Khi ngày đã lên lịch đến, bài đăng sẽ được xuất bản, tại thời điểm đó phản hồi thành công hoặc lỗi cuối cùng sẽ được gửi qua webhook hoặc endpoint /history.Để bỏ qua bước xác thực trước này, hãy đặt validateScheduled thành false.Chúng tôi khuyến nghị giữ xác thực được bật cho các bài đăng đã lên lịch để bắt lỗi sớm. Nếu không, bài đăng sẽ được lên lịch và bạn sẽ chỉ nhận được lỗi khi nó được xuất bản.Vui lòng xem các hành động webhook đã lên lịch để biết thêm chi tiết.
firstComment
object
Tự động thêm bình luận đầu tiên sau khi đăng bài. Xem bình luận đầu tiên để biết chi tiết.
disableComments
boolean
mặc định:false
Tắt bình luận cho bài đăng. Chỉ khả dụng cho Instagram, LinkedIn, và TikTok.
Rút gọn liên kết trong bài đăng cho tất cả các nền tảng bằng link shortener của Ayrshare.Chỉ các URL bắt đầu bằng https sẽ được rút gọn.Yêu cầu Max Pack cho tính năng rút gọn liên kết.Vui lòng xem tại đây để sử dụng link shorteners bên thứ 3.
autoSchedule
object
Vui lòng xem auto-schedule để biết chi tiết.
autoRepost
object
Tự động đăng lại nội dung của bạn nhiều lần vào các khoảng thời gian đều đặn, tạo ra nội dung evergreen luôn tươi mới và hiển thị với đối tượng của bạn.Xem auto repost để biết chi tiết.
autoHashtag
object
Xem auto hashtags để biết chi tiết.
unsplash
string
Xem unsplash để biết chi tiết.
blueskyOptions
object
faceBookOptions
object
instagramOptions
object
linkedInOptions
object
pinterestOptions
object
redditOptions
object
snapChatOptions
object
telegramOptions
object
threadsOptions
object
tikTokOptions
object
twitterOptions
object
youTubeOptions
object
requiresApproval
boolean
mặc định:false
Xem quy trình phê duyệt để biết chi tiết.
randomPost
boolean
mặc định:false
Tạo nội dung bài đăng ngẫu nhiên cho việc kiểm thử. randomPost: true sẽ bỏ qua trường post.
randomMediaUrl
boolean
mặc định:false
Tạo hình ảnh phương tiện ngẫu nhiên cho việc kiểm thử. randomMediaUrl: true sẽ bỏ qua trường mediaUrls.
idempotencyKey
string
Một ID duy nhất tùy chọn được liên kết với bài đăng. Các ID trùng lặp sẽ bị từ chối. Vui lòng xem idempotency để biết chi tiết.
notes
string
Đặt ghi chú trên bài đăng có thể được truy xuất qua endpoint /history. Ghi chú chỉ để tham khảo và không ảnh hưởng đến bài đăng.