API đăng bàiAPI

Một lệnh POST để đăng ở mọi nơi

Tạo bài đăng một lần, liệt kê các tài khoản cần đăng, và FoPost lo phần định dạng, tải phương tiện lên và gửi đến từng mạng. Khóa có phạm vi, yêu cầu idempotent, và trạng thái gửi bạn có thể truy vấn hoặc nhận qua webhook.

POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Shipped a new release today." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

curl -X POST https://api.fopost.com/v1/posts/7d3e0a52-.../publish \
  -H "X-API-Key: $API_KEY"

Mọi mạng, một cấu trúc

Cùng một nội dung yêu cầu đăng lên X, LinkedIn, Instagram và mọi tài khoản đã kết nối khác.

Khóa có phạm vi

Khóa có phạm vi publish chỉ được đăng bài, không gì khác. Thu hồi nó mà không ảnh hưởng các khóa khác.

Trạng thái gửi theo tài khoản

Mỗi tài khoản báo cáo trạng thái, external id và permalink riêng khi bài đã lên.

Đăng bài

Viết bài một lần, nhắm đến bất kỳ nhóm tài khoản nào

Truyền văn bản, phương tiện và các tài khoản cần đăng. FoPost áp dụng giới hạn và quy ước của từng mạng, tải phương tiện lên theo định dạng nền tảng yêu cầu, và trả về một post id để bạn theo dõi. Chuỗi bài, carousel và bài dài đều dùng chung một mảng content.

Đọc tài liệu tham khảo về đăng bài
Phản hồi
{
  "post_status": "publishing",
  "deliveries": [
    { "id": "a3c5e7f9-...", "account_id": "4a71d80b-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 },
    { "id": "b4d6f8a0-...", "account_id": "c30e9f12-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 }
  ],
  "health_warnings": []
}

Khối nội dung

Các khối theo thứ tự sẽ trở thành chuỗi bài, carousel hoặc phần thân bài tùy theo mạng.

Phương tiện theo tham chiếu

Tải lên thư viện phương tiện một lần và đính kèm theo id vào bao nhiêu bài đăng cũng được.

Idempotent

Gửi kèm idempotency key và yêu cầu thử lại sẽ không bao giờ đăng trùng.

Theo dõi

Biết chính xác mỗi bài đăng đã lên ở đâu

Một bài đăng tách thành một lượt gửi cho mỗi tài khoản. Truy vấn endpoint deliveries hoặc đăng ký webhook, bạn sẽ nhận được trạng thái trên nền tảng, external id, permalink và nội dung lỗi khi một mạng từ chối.

Xem sự kiện webhook
Các tài khoản đã kết nối trên mọi mạng trong một không gian làm việc

Endpoint deliveries

GET /v1/posts/:id/deliveries liệt kê mọi tài khoản cùng trạng thái riêng.

Sự kiện webhook

delivery.published và delivery.failed được kích hoạt ngay khi một lượt gửi hoàn tất.

Tích hợp sẵn cơ chế thử lại

Lỗi tạm thời của nền tảng được thử lại với backoff trước khi bị báo là thất bại.

Quản lý

Sửa, hủy và xóa bằng code

Toàn bộ vòng đời đều có trên API. Cập nhật bài đã lên lịch trước khi đăng, hủy nó, hoặc xóa bài đã đăng khỏi mạng nơi nó xuất hiện. Nhãn và không gian làm việc giúp tách biệt công việc của từng khách hàng khi bạn quản lý nhiều thương hiệu.

Bắt đầu xây dựng
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": [{ "text": "Updated copy." }] }'

Sửa trước khi đăng

Thay đổi văn bản, phương tiện hoặc tài khoản cho bất kỳ bài nào còn trong hàng đợi.

Nhãn

Gắn nhãn bài đăng theo chiến dịch hoặc khách hàng và lọc mọi endpoint danh sách theo nhãn.

Không gian làm việc

Khóa tính theo không gian làm việc, nên khách hàng này không bao giờ truy cập được dữ liệu của khách hàng khác.

Giải đáp câu hỏi về API đăng bài

Xác thực như thế nào?

Tạo khóa API trong mục Cài đặt của bảng điều khiển, rồi gửi nó trong header X-API-Key. Mỗi khóa thuộc về một không gian làm việc và chỉ mang những phạm vi bạn cấp.

Tôi có thể đăng lên những mạng nào?

Mọi tài khoản đã kết nối với không gian làm việc, trên mọi mạng mà FoPost hỗ trợ. Cấu trúc yêu cầu giống nhau cho tất cả.

Tôi có thể đính kèm ảnh và video không?

Có. Tải lên qua API phương tiện một lần, rồi tham chiếu media id trong bài đăng. Giới hạn kích thước và định dạng của từng mạng được tự động áp dụng.

Chuyện gì xảy ra nếu một mạng bị sập?

Lượt gửi sẽ được thử lại với backoff. Nếu vẫn thất bại, lượt gửi được đánh dấu là failed kèm lỗi của nền tảng, và webhook delivery.failed được kích hoạt.

Có giới hạn tần suất không?

Có, 100 yêu cầu mỗi phút cho mỗi khóa. Giới hạn và số lượt còn lại được trả về trong header phản hồi.

Có SDK không?

Một SDK TypeScript có kiểu dữ liệu, một máy chủ MCP cho AI client, và các gói PHP, Laravel, WordPress miễn phí. Bản đặc tả OpenAPI được cung cấp từ API cho mọi ngôn ngữ khác.

Xây dựng trên API đăng bài ngay hôm nay

Bắt đầu miễn phí và đã bao gồm đầy đủ API. Tạo khóa và thực hiện lệnh gọi đầu tiên chỉ trong vài phút.

Lấy khóa API