필드 하나로 게시물 예약
지금 게시할 때와 같은 본문에 schedule_at 타임스탬프만 추가하면, FoPost가 그때까지 대기열에 보관해요. 게시되는 순간까지 모든 내용을 수정할 수 있고, 전송 결과는 계정별로 보고돼요.
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-..."]
}'타임스탬프 하나
미래의 ISO 8601 시간이면 무엇이든 돼요. 대기열이 받아서 일정대로 게시해요.
전송 전까지 수정 가능
대기열에 있는 게시물의 텍스트, 미디어, 계정, 시간을 PUT으로 변경하세요.
계정별 전송
게시되면 각 계정이 자체 상태와 퍼머링크를 알려 줘요.
스크립트 하나로 일주일 치 게시물 계획
콘텐츠를 반복 처리하면서 항목마다 시간을 정하고 게시물을 만드세요. 대기열은 FoPost에서 실행되므로 요청이 반환되는 즉시 자체 프로세스를 종료해도 돼요. 예약된 게시물 목록을 언제든 조회해 앞으로의 일정을 확인하세요.
게시물 레퍼런스 읽기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 }
}상태별 필터
쿼리 파라미터 하나로 초안, 예약, 게시, 실패 게시물을 조회하세요.
라벨
게시물마다 캠페인 태그를 달고 대기열을 라벨로 필터링하세요.
워크스페이스별
키는 하나의 워크스페이스만 보기 때문에 한 클라이언트의 대기열이 다른 클라이언트와 섞이지 않아요.
게시 전에 옮기고, 고쳐 쓰고, 취소
계획은 바뀌기 마련이에요. 예약된 게시물을 PUT으로 보내 시간, 텍스트, 미디어, 대상 계정을 변경하세요. 취소하면 취소됨으로 표시되어 전송되지 않고, 아예 삭제할 수도 있어요. 대기열이 가져가기 전까지는 아무것도 잠기지 않아요.
PUT 엔드포인트 보기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" }'일정 변경
schedule_at을 바꾸면 대기열이 게시물을 새 시간으로 옮겨요.
콘텐츠 교체
대기열에 있는 게시물의 content 배열이나 미디어 id를 교체하세요.
취소 또는 삭제
대기열의 다른 항목에는 영향 없이 게시물 하나만 빼낼 수 있어요.
폴링 없이 게시 여부 확인
예약 시간이 되면 게시물이 계정별 전송으로 나뉘어요. 웹훅을 등록하면 각 전송마다 delivery.published 또는 delivery.failed가 발생하고, 풀 방식을 선호한다면 deliveries 엔드포인트를 폴링하면 돼요.
개발 시작하기
완료 시 웹훅
delivery.published에는 게시물 id, 계정, 퍼머링크가 담겨요.
재시도
일시적인 네트워크 오류는 실패가 보고되기 전에 백오프로 재시도돼요.
게시 후 분석
게시된 후에는 같은 게시물 id로 Analytics API에서 노출수와 참여를 조회할 수 있어요.