API lên lịchAPI

Lên lịch bài đăng chỉ với một trường

Gửi đúng nội dung bạn sẽ đăng ngay, thêm một mốc thời gian schedule_at, và FoPost giữ bài trong hàng đợi đến lúc đó. Mọi thứ vẫn sửa được cho đến khi đăng, và trạng thái gửi được báo cáo theo từng tài khoản.

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-...",
    "status": "scheduled",
    "schedule_at": "2026-09-01T09:00:00Z",
    "content": [{ "text": "Webhook retries are live. Read the changelog." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

Một mốc thời gian

Bất kỳ thời điểm ISO 8601 nào trong tương lai. Hàng đợi tiếp nhận và đăng đúng lịch.

Sửa được đến khi gửi

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

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

Khi đã đăng, mỗi tài khoản báo cáo trạng thái và permalink riêng.

Hàng đợi

Lên kế hoạch bài đăng cả tuần trong một script

Lặp qua nội dung của bạn, chọn thời gian cho từng mục và tạo bài đăng. Hàng đợi chạy trong FoPost, nên tiến trình của bạn có thể thoát ngay khi yêu cầu trả về. Liệt kê các bài đã lên lịch bất cứ lúc nào để xem sắp có gì.

Đọc tài liệu tham khảo về bài đăng
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
    { "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}

Lọc theo trạng thái

Liệt kê bài nháp, đã lên lịch, đã đăng hoặc thất bại chỉ với một tham số truy vấn.

Nhãn

Gắn nhãn từng bài theo chiến dịch và lọc hàng đợi theo nhãn.

Theo từng không gian làm việc

Một khóa chỉ thấy một không gian làm việc, nên hàng đợi của khách hàng này không bao giờ lẫn với khách hàng khác.

Điều chỉnh

Dời lịch, viết lại hoặc hủy trước khi đăng

Kế hoạch luôn thay đổi. PUT một bài đã lên lịch để đổi thời gian, văn bản, phương tiện hoặc tài khoản đích. Hủy bài thì nó được đánh dấu cancelled và không bao giờ được gửi, hoặc xóa hẳn. Không có gì bị khóa cho đến khi hàng đợi tiếp nhận.

Xem endpoint PUT
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 '{ "schedule_at": "2026-09-01T14:00:00Z" }'

Đổi lịch

Đổi schedule_at và hàng đợi sẽ dời bài sang thời gian mới.

Thay nội dung

Thay mảng content hoặc các media id của một bài trong hàng đợi.

Hủy hoặc xóa

Rút một bài khỏi hàng đợi mà không ảnh hưởng gì khác trong đó.

Xác nhận

Biết khi nào bài đã lên, không cần truy vấn liên tục

Khi đến giờ đã lên lịch, bài đăng tách thành một lượt gửi cho mỗi tài khoản. Đăng ký webhook và delivery.published hoặc delivery.failed sẽ được kích hoạt cho từng lượt, hoặc truy vấn endpoint deliveries nếu bạn thích mô hình kéo dữ liệu.

Bắt đầu xây dựng
Một tháng bài đăng đã lên lịch trên lịch đăng bài

Webhook khi hoàn tất

delivery.published mang theo post id, tài khoản và permalink.

Thử lại

Lỗi mạng tạm thời được thử lại với backoff trước khi báo thất bại.

Phân tích sau khi đăng

Khi bài đã lên, chính post id đó đọc lại lượt hiển thị và tương tác từ API phân tích.

Giải đáp câu hỏi về API lên lịch

Tôi có thể lên lịch trước bao lâu?

Bao lâu tùy bạn. Mọi mốc thời gian ISO 8601 trong tương lai đều được chấp nhận, và hàng đợi giữ bài đến lúc đó.

schedule_at dùng múi giờ nào?

Gửi mốc thời gian ISO 8601 theo UTC, kết thúc bằng Z. Giá trị bạn gửi là giá trị được chạy; máy chủ không chuyển đổi gì.

Tôi có thể sửa bài sau khi đã lên lịch không?

Có. PUT bất kỳ trường nào, kể cả thời gian, cho bài chưa được đăng. Khi bài đã đăng, chỉnh sửa áp dụng cho bản ghi, và bạn dùng delete để gỡ bài khỏi một mạng.

Chuyện gì xảy ra nếu máy chủ của tôi bị sập vào giờ đăng?

Không có gì thay đổi. Hàng đợi chạy bên trong FoPost, không phải trên hạ tầng của bạn, nên bài vẫn được đăng dù tiến trình của bạn có đang chạy hay không.

Tôi có thể lên lịch cho một số tài khoản nhất định không?

Có. Mảng accounts là danh sách đích. Chỉ đưa vào những tài khoản cần nhận bài, và mỗi tài khoản có bản ghi gửi riêng.

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. Lên lịch bài đăng cả tuần trong một script vẫn nằm thoải mái trong giới hạn này.

Xây dựng trên API lên lịch 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