Tổng quan Post API

​

Quy trình phê duyệt

​

Ví dụ quy trình phê duyệt

{
  "requiresApproval": true,
  "notes": "need approval by John Smith" // optional
}

​

Video quy trình phê duyệt

​

Auto Hashtag

• max: (tùy chọn) Integer số hashtag để thêm, phạm vi 1-10. Mặc định 2.
• position: (tùy chọn) String “auto” hoặc “end”. Auto thêm hashtag trong bài đăng hoặc ở cuối. “end” thêm hashtag chỉ ở cuối.

{
  "hashtags": {
    "max": 3, // optional: Integer range 1-10
    "position": "auto" // optional: String "auto" or "end"
  }
}

{
  "autoHashtag": true
}

​

Auto Repost

• repeat: (bắt buộc) Số lần đăng lại nội dung. Phải nằm trong khoảng từ 1 đến 10.
• days: (bắt buộc) Số ngày giữa mỗi lần đăng lại. Phải ít nhất 2 ngày.
• startDate: (tùy chọn) Khi nào bắt đầu lịch đăng lại, ở định dạng ISO-8601 UTC. Nếu không được chỉ định, bài đăng đầu tiên sẽ được xuất bản ngay lập tức. Bạn nên sử dụng tham số startDate thay cho tham số scheduleDate cấp cao nhất.

{
  "repeat": 2, // min 2, max 10
  "days": 5, // min 2
  "startDate": "2021-07-08T12:30:00Z"
}

{
  "status": "scheduled",
  "scheduleDate": "2025-06-13T12:30:00.000Z",
  "id": "eIT96IYEodNuzU4oMmwG",
  "refId": "9abf1426d6ce9122ef11c72bd",
  "autoRepostId": "F5wdoaOAAGtDQVciExSxL",
  "post": "The most important things are the hardest to say - Stephen King"
}

​

Bình luận đầu tiên (First Comment)

{
  "firstComment": {
    "comment": "My first comment", // required
    "mediaUrls": ["https://..."] // Facebook, LinkedIn, and X/Twitter only
  }
}

​

Thời gian xử lý bình luận đầu tiên

​

Bài đăng Idempotent

{
  "idempotencyKey": "Unique Key"
}

​

Yêu cầu hình ảnh & video

​

URL hợp lệ

const run = async () => {
  const url = "https://img.ayrshare.com/012/gb.jpg";
  return await fetch(url, {
    method: "HEAD"
  })
    .then((res) => {
      if (res.ok) {
        return console.log("Success:", res.status, res.statusText);
      } else {
        return console.error("Error:", res.status, res.statusText, res);
      }
    })
    .catch((error) => {
      return console.error("Error Catch:", error);
    });
};

run();

​

Bảo vệ phương tiện tự động

{
    "postIds": [
        {
            "status": "success",
            "platform": "instagram",
            "id": "17878176260289172",
            "postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
            "contentIssues": {
                "originMediaHostFailed": true,
                "details": ["Media URL could not be retrieved by the social network. Successfully posted using Ayrshare automated media protection."]
            }
        }
    ]
}

​

Khoảng trắng & ký tự đặc biệt

• Khoảng trắng trong URL.
• Khoảng trắng được mã hóa URL trong URL.
• Ký tự đặc biệt trong URL ngay cả khi chúng được mã hóa url, chẳng hạn như dấu trọng âm é.

https://img.ayrshare.com/012/test .webp

https://unsplash.com/photos/a-house-in-the-middle-of-a-field-with-trees-in-the-background-znbmh2-cIj0

​

Làm sạch tên file & URL

const sanitizeFileName = (url) => url.replace(/[^a-z0-9\/\.]/gi, "_");
sanitizeFileName("tést .webp"); // t_st_.webp

const sanitizeUrl = (url) => {
  const [protocol, rest] = url.split("://");
  const [domain, ...path] = rest.split("/");
  const sanitizedPath = path.join("/").replace(/[^a-z0-9\/\.]/gi, "_");
  return `${protocol}://${domain}/${sanitizedPath}`;
};

// Output: https://img.ayrshare.com/012/t_st_.webp
sanitizeUrl("https://img.ayrshare.com/012/tést .webp");

​

Thông tin bổ sung

​

Tốc độ tải xuống

​

Phần mở rộng video

​

Chỉ hình ảnh hoặc video

​

Kiểm thử hình ảnh và video

​

Ngắt dòng

​

Bài đăng đa nền tảng và phương tiện

1. Sử dụng cấu trúc đối tượng cho các trường post và/hoặc mediaUrls.
2. Chỉ định nội dung cho từng nền tảng bằng tên nền tảng làm khóa.
3. Bao gồm khóa default cho nội dung được sử dụng trên các nền tảng không được chỉ định rõ ràng.

{
  "post": {
    "instagram": "Great IG pic!",
    "facebook": "Great FB pic!",
    "default": "Great default pic!"
  },
  "platforms": ["instagram", "facebook", "linkedin"],
  "mediaUrls": {
    "instagram": "https://img.ayrshare.com/012/gb.jpg",
    "linkedin": "https://img.ayrshare.com/012/gb.jpg",
    "default": "https://img.ayrshare.com/012/gb.jpg"
  }
}

• Instagram sẽ sử dụng văn bản cụ thể và URL hình ảnh của nó.
• Facebook sẽ sử dụng văn bản cụ thể và URL hình ảnh mặc định.
• LinkedIn sẽ sử dụng văn bản mặc định và URL hình ảnh cụ thể của nó.

​

Profile Keys

​

Bài đăng văn bản phong phú

{
    "post": "<var>Hello</var>, how about a little <b>bold text</b> and <i>italics text</i> and an x<sub>2</sub>?"
    "platforms": ["twitter"]
}

​

Các phần tử HTML

​

Mã CSS

​

Lên lịch bài đăng

​

Tạo bài đăng đã lên lịch

{
  "post": "Hello, world!",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["facebook", "instagram"],
  "scheduleDate": "2023-07-08T12:30:00Z"
}

​

Kiểm tra trạng thái bài đăng đã lên lịch

• Thiết lập Webhook Scheduled Action để tự động nhận trạng thái của bài đăng đã lên lịch. Điều này có sẵn cho Business plan và là phương pháp được khuyến nghị.
• Lấy trạng thái của bài đăng đã lên lịch với lệnh gọi GET với post ID.
• Kiểm tra trạng thái trong Ayrshare Dashboard. Trước tiên chuyển sang User Profile mà bài đăng đã được xuất bản, sau đó vào trang “Posts” và tìm kiếm bằng Ayrshare Post ID.

​

Tạm dừng bài đăng đã lên lịch

​

Rút gọn liên kết

{
  "post": "Hello, world with a link https://www.ayrshare.com",
  "platforms": ["linkedin"],
  "shortenLinks": true
}

​

Hình ảnh Unsplash

• Hình ảnh ngẫu nhiên: random trả về một hình ảnh Unsplash ngẫu nhiên.
• Hình ảnh dựa trên tìm kiếm: giá trị String cụm từ tìm kiếm; ví dụ, money sẽ chọn một hình ảnh ngẫu nhiên dựa trên money.
• Image IDs: giá trị Array of Ids; ví dụ [“HubtZZb2fCM”] của hình ảnh https://unsplash.com/photos/HubtZZb2fCM

{
  "post": "Hello, world!",
  "platforms": ["instagram"],
  "unsplash": "random",
  "unsplash": "search term", // unsplash: "money"
  "unsplash": ["unsplash image ID"] // unsplash: ["HubtZZb2fCM"]
}