예약과 취소

예약 생성

계정의 capabilities.schedulePosts를 확인하세요. 발행과 같은 플랫폼별 입력을 /scheduled-posts에 보내고 scheduledAt을 추가합니다. 아래는 Threads·X·LinkedIn 텍스트 예제이며 계정 ID를 바꿔야 합니다.

<future-time-with-offset>을 현재부터 360일 이내의 미래 ISO 8601 시각으로 바꾸세요. 예를 들어 원하는 날짜의 T09:00:00+09:00은 한국 시각 오전 9시입니다. timezone은 IANA 이름이며 생략하면 워크스페이스 기본값, 없으면 UTC를 사용합니다. 전송 시각 자체는 scheduledAt의 오프셋으로 정해집니다.

curl --request POST "https://www.posteady.com/api/v1/scheduled-posts" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "accountIds": [
    "11111111-1111-4111-8111-111111111111"
  ],
  "posts": [
    "See you tomorrow!"
  ],
  "scheduledAt": "<future-time-with-offset>",
  "timezone": "Asia/Seoul"
}'

텍스트 예약 결과의 scheduledPostIds를 저장하세요. 여러 계정이면 결과를 각각 확인합니다. TikTok·Instagram·YouTube·Facebook 입력은 각 플랫폼 가이드에서 가져와 같은 방식으로 예약할 수 있습니다.

텍스트 예약은 모든 대상이 실패하면 HTTP 502입니다. 비동기 예약은 접수와 발행 완료가 다릅니다. 기존 요청을 다시 보낼 때의 응답은 재시도 안내를 참고하세요.

예약 조회

curl --request GET "https://www.posteady.com/api/v1/scheduled-posts?provider=threads" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

응답의 scheduledPosts 배열에서 scheduledPostId와 platform을 가져오세요. provider를 생략하면 지원 플랫폼을 함께 조회합니다. 이 API에는 날짜 필터나 페이지네이션 인자가 없습니다. 비동기 예약은 jobId로 발행 상태를 확인할 수 있습니다.

예약 취소

다음 합성 ID를 실제 scheduledPostId로 바꾸고 platform도 일치시키세요.

curl --request DELETE "https://www.posteady.com/api/v1/scheduled-posts/55555555-5555-4555-8555-555555555555?platform=threads" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

{
  "canceled": 1
}

Threads·X 체인의 글 하나를 취소하면 전체 체인이 취소될 수 있으므로 canceled 수를 확인하세요. TikTok·Instagram·YouTube·Facebook은 전송을 시작하기 전까지만 취소할 수 있으며 이후에는 409 POST_NOT_CANCELLABLE을 반환합니다. 취소는 이미 발행된 소셜 게시물을 삭제하지 않습니다.

API로 접수한 Instagram·Facebook 예약의 내용·미디어·계정은 고정됩니다. Posteady에서 예약 시각 변경 또는 발행 전 취소를 사용할 수 있습니다. Facebook 즉시 작업과 unknown 작업은 예약 목록에 나타나지 않습니다.

플랫폼별 입력 · 예약 레퍼런스