POST 한 번으로 모든 곳에 게시
게시물을 한 번 만들고 게시할 계정을 지정하면, 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-...",
"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"모든 네트워크, 하나의 형식
같은 요청 본문으로 X, LinkedIn, Instagram을 비롯해 연결된 모든 계정에 게시해요.
범위 지정 키
publish 범위가 있는 키는 게시만 할 수 있어요. 다른 키에 영향을 주지 않고 폐기할 수 있어요.
계정별 전송
게시되면 각 계정이 자체 상태, 외부 id, 퍼머링크를 알려 줘요.
게시물은 한 번만 쓰고, 원하는 계정에 게시
텍스트, 미디어, 게시할 계정을 전달하세요. FoPost가 네트워크별 제한과 관례를 적용하고, 플랫폼이 원하는 형식으로 미디어를 업로드한 뒤, 추적할 수 있는 게시물 id를 반환해요. 스레드, 캐러셀, 긴 본문 모두 같은 content 배열로 처리돼요.
게시 레퍼런스 읽기{
"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": []
}콘텐츠 블록
순서가 있는 블록이 네트워크에 따라 스레드, 캐러셀 또는 본문이 돼요.
참조 기반 미디어
미디어 라이브러리에 한 번 업로드하고 id로 여러 게시물에 첨부하세요.
멱등성
멱등성 키를 보내면 재시도한 요청이 중복 게시되지 않아요.
모든 게시물이 어디에 게시됐는지 정확히 파악
게시물 하나가 계정별 전송으로 나뉘어요. deliveries 엔드포인트를 폴링하거나 웹훅을 구독하면 플랫폼 상태, 외부 id, 퍼머링크, 그리고 네트워크가 거부한 경우 오류 메시지를 받을 수 있어요.
웹훅 이벤트 보기
Deliveries 엔드포인트
GET /v1/posts/:id/deliveries가 모든 계정과 각 계정의 상태를 보여 줘요.
웹훅 이벤트
전송이 완료되는 즉시 delivery.published와 delivery.failed가 발생해요.
재시도 기본 제공
일시적인 플랫폼 오류는 실패로 표시되기 전에 백오프로 재시도돼요.
코드로 수정, 취소, 삭제
전체 수명 주기를 API로 다룰 수 있어요. 예약된 게시물을 게시 전에 수정하거나 취소하고, 게시된 게시물을 해당 네트워크에서 삭제하세요. 여러 브랜드를 운영할 때는 라벨과 워크스페이스로 클라이언트 작업을 분리할 수 있어요.
개발 시작하기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." }] }'게시 전 수정
대기열에 있는 게시물의 텍스트, 미디어, 계정을 변경하세요.
라벨
게시물에 캠페인이나 클라이언트별 태그를 달고, 모든 목록 엔드포인트를 라벨로 필터링하세요.
워크스페이스
키는 워크스페이스별이라 한 클라이언트가 다른 클라이언트에 접근할 수 없어요.