Kết nối các tài khoản mạng xã hội của bạn
Đăng nhập hoặc đăng ký tài khoản Ayrshare. Trên trang Social Account, nhấp vào các mạng xã hội mà bạn muốn kết nối. Vui lòng đảm bảo cấp tất cả các quyền.
Lấy API Key của bạn
Cần có API Key để cấp quyền truy cập vào các endpoint API. Khóa này được sử dụng trong header của yêu cầu và phải được đặt sau từ khóaBearer.
API Key của bạn nằm trong Ayrshare Dashboard, trên trang API Key. Nếu cần, hãy chuyển sang ‘Primary Profile’ của bạn qua trang User Profiles.
Từ đó, bạn có thể tìm thấy trang API Key trong bảng bên trái.

Bearer Token. Cũng bao gồm Content-Type là application/json.
Header
Gửi bài đăng API đầu tiên của bạn
Xuất bản bài đăng
Dưới đây là các ví dụ mã cho thấy cách thực hiện một bài đăng bằng API của chúng tôi trong các ngôn ngữ lập trình khác nhau. Để tích hợp dễ dàng hơn nữa, bạn có thể sử dụng một trong các gói SDK được xây dựng sẵn của chúng tôi. Để đăng bài, bạn sẽ cần:- API Key của bạn để xác thực.
- Nội dung văn bản của bài đăng của bạn.
- Các nền tảng mạng xã hội mà bạn muốn đăng lên (chỉ bao gồm các nền tảng bạn đã liên kết).
- Tùy chọn: URL của bất kỳ hình ảnh hoặc video nào bạn muốn thêm vào.
Đăng lên X/Twitter? X yêu cầu thông tin xác thực API của riêng bạn. Thêm 2 header BYO (
X-Twitter-OAuth1-Api-Key và X-Twitter-OAuth1-Api-Secret) vào yêu cầu của bạn. Đây là thiết lập một lần cho mỗi tài khoản Ayrshare, và cùng một cặp khóa hoạt động cho mọi sub-profile / người dùng cuối. Xem hướng dẫn thiết lập để biết chi tiết.Phản hồi bài đăng
Bạn sẽ nhận được phản hồi vớistatus là “success” khi API của chúng tôi xử lý thành công bài đăng của bạn. Phản hồi bao gồm:
status: Trạng thái tổng thể của lệnh gọi API (“success” hoặc “error”)errors: Mảng chứa các lỗi gặp phải (rỗng nếu thành công)postIds: Mảng các đối tượng chứa chi tiết riêng của từng nền tảng:- Tên nền tảng
- ID bài đăng trên nền tảng đó
- URL để xem bài đăng
- Thông tin bổ sung riêng của từng nền tảng
postIds sẽ có trạng thái riêng, cho phép bạn xác minh những nền tảng nào đã nhận bài đăng thành công.
Hãy kiểm tra các trang mạng xã hội của bạn để đảm bảo bài đăng đã được xử lý thành công và đang hiển thị. Lưu ý rằng một số nền tảng có thể có độ trễ nhẹ trước khi bài đăng xuất hiện công khai.
Đây là một phản hồi mẫu:
Post Response
Post
Đi sâu hơn một chút
Hãy phân tích quy trình những gì vừa xảy ra khi chúng ta thực hiện lệnh gọi API này.Tạo đối tượng Body
Tiếp theo, chúng ta đã tạo một đối tượng body:
- Post chứa văn bản “Today is a great day!”.
- Các nền tảng mạng xã hội Facebook, Instagram và LinkedIn. Bạn chỉ nên bao gồm các nền tảng đã liên kết trên trang Social Linkage.
- Đã thêm một hình ảnh vào mediaUrls.
Trước khi bạn đi, một số thực tiễn tốt nhất
Đọc tài liệu
Chúng tôi duy trì tài liệu phong phú và cập nhật. Vì bạn đã ở đây, hãy dành thời gian xem qua các phần của tài liệu ở thanh điều hướng bên trái.Mã lỗi rất quan trọng
Bạn cần xử lý chúng để người dùng có trải nghiệm tuyệt vời.Lỗi
Giữ API Key của bạn an toàn
Chúng tôi coi trọng bảo mật, và bạn cũng nên như vậy. Bạn có toàn quyền kiểm soát kết nối giữa Ayrshare và các tài khoản mạng xã hội của bạn. Khi các tài khoản đã được kết nối, Ayrshare API key trở thành cách bạn xác thực. Vui lòng giữ khóa này bí mật và an toàn.Xuất bản bài đăng thử nghiệm
Bạn có thể xuất bản bài đăng thử nghiệm với trích dẫn, hình ảnh hoặc video ngẫu nhiên bằng cách sử dụng các tham sốrandomPost, randomMediaUrl, và isLandscapeVideo hoặc isPortraitVideo trong endpoint /post. Nếu bạn sử dụng randomPost, thì tham số post không bắt buộc.
Trích dẫn ngẫu nhiên
Gửi trích dẫn ngẫu nhiên để thử nghiệm xuất bản bài đăng bằng cách thêmrandomPost: true.
Được sử dụng với endpoint /post.
Hình ảnh ngẫu nhiên
Gửi hình ảnh ngẫu nhiên bằng cách thêmrandomMediaUrl: true.
Được sử dụng với endpoint /post.
Video ngẫu nhiên
Gửi video ngang ngẫu nhiên bằng cách thêmisVideo: true và isLandscapeVideo: true.
Video sẽ có kích thước ngang tiêu chuẩn.
Được sử dụng với endpoint /post.
isVideo: true và isPortraitVideo: true.
Được sử dụng với endpoint /post.
Bình luận ngẫu nhiên
Gửi bình luận ngẫu nhiên để thử nghiệm xuất bản bình luận bằng cách thêmrandomComment: true.
Được sử dụng với endpoint /comment.
