Chuyển đến nội dung chính
Hướng dẫn này dành cho việc thiết lập một công ty duy nhất. Đối với các đăng ký Business Plan và Enterprise Plan với nhiều người dùng, một hướng dẫn tích hợp được cá nhân hóa sẽ được cung cấp.

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.

Facebook Linking Example

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óa Bearer. 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. API Key Mỗi lệnh gọi API phải bao gồm API Key trong Header sử dụng một Bearer Token. Cũng bao gồm Content-Typeapplication/json.
Header
Xem Authorization để biết thêm thông tin.

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.
Tất cả các ví dụ đều sử dụng endpoint /post. Hãy xem một số mã mẫu:
Đă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-KeyX-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.
Chúc mừng! Bạn vừa gửi bài đăng đầu tiên của mình.

Phản hồi bài đăng

Bạn sẽ nhận được phản hồi với status 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
Mỗi nền tảng trong mả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
Xem thêm các ví dụ mã gọi API mạng xã hội trong Node.js, Python, PHP, Golang, C#, và Ruby, cùng các khả năng tuyệt vời khác:

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.
1

Đặt Header

Chúng ta đã đặt Header Authorization bearer token (API Key) và content type là json.
2

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.
3

Gọi endpoint /post

Gửi mọi thứ dưới dạng HTTP POST đến endpoint /post.

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.
Các bài đăng này sẽ hiển thị trực tiếp trên các trang mạng xã hội của bạn, vì vậy nếu thích hợp, hãy xóa chúng sau khi thử nghiệm.

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êm randomPost: 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êm randomMediaUrl: 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êm isVideo: trueisLandscapeVideo: true. Video sẽ có kích thước ngang tiêu chuẩn. Được sử dụng với endpoint /post.
Gửi video dọc ngẫu nhiên, cần thiết cho TikTok hoặc Reels trên Facebook/Instagram, bằng cách thêm isVideo: trueisPortraitVideo: 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êm randomComment: true. Được sử dụng với endpoint /comment.

Ví dụ lệnh gọi cURL

Gửi trích dẫn ngẫu nhiên và video dọc.

Sử dụng Postman để kiểm thử các lệnh gọi API của bạn

Postman là một công cụ tuyệt vời để kiểm thử các lệnh gọi API. Bạn thậm chí có thể tạo mã trong hơn một chục ngôn ngữ.

Mã demo

Nếu bạn đang tìm kiếm dự án demo mẫu trong React và NodeJS, vui lòng xem repository GitHub này:

Ứng dụng Demo Đăng bài Xã hội trên Github

Xử lý sự cố thường gặp

Đôi khi mọi thứ không diễn ra suôn sẻ, vì vậy đây là một chút trợ giúp trong trung tâm hỗ trợ của chúng tôi.

Xử lý sự cố

Liên hệ với chúng tôi để được trợ giúp

Chúng tôi ở đây để giúp đỡ, vì vậy vui lòng sử dụng trò chuyện ở góc dưới bên phải hoặc gửi email cho chúng tôi.