발행 작업의 상태
접수와 발행 완료를 구분하고 비동기 작업의 결과를 확인하세요.
발행 방식
Threads·X·LinkedIn 텍스트 발행은 요청 안에서 처리하며 계정별 결과를 반환합니다. TikTok·Instagram·YouTube·Facebook 발행은 작업을 접수하고 이후 처리합니다. Facebook 텍스트 FEED도 비동기입니다.
비동기 신규 발행은 HTTP 202와 다음 형태의 응답을 반환합니다.
{
"results": [
{
"accountId": "11111111-1111-4111-8111-111111111111",
"provider": "youtube",
"username": "example",
"success": true,
"postIds": [],
"jobId": "44444444-4444-4444-8444-444444444444",
"status": "queued"
}
],
"summary": {
"succeeded": 1,
"failed": 0
}
}success: true와 summary.succeeded는 접수 성공을 뜻합니다. 실제 발행은 status: published로 확인하세요.
상태 조회
반환된 jobId로 조회하세요. 아래 ID는 합성 예시입니다.
curl --request GET "https://www.posteady.com/api/v1/publish-jobs/44444444-4444-4444-8444-444444444444" \
--header "Authorization: Bearer $POSTEADY_API_KEY"| 상태 | 의미 |
|---|---|
queued | 처리 대기 |
scheduled | 예약 시각 대기 |
processing | 플랫폼으로 전송·처리 중 |
published | 발행 확인됨 |
failed | 확인된 오류로 실패 |
canceled | 전송 시작 전 취소됨 |
unknown | 최종 전송 결과를 확정할 수 없음 |
응답에는 jobId·scheduledPostId·platform·accountId·username·status·postId·permalink·scheduledAt이 포함됩니다. postId와 permalink는 확인되기 전까지 null일 수 있으며 즉시 발행의 scheduledAt은 null입니다. 실패 시 error.code와 error.message를 확인하세요.
조회도 API 속도 제한에 포함됩니다. published·failed·canceled·unknown이면 자동 폴링을 멈추고 결과를 처리하세요. 진행 중에는 다른 호출과 합쳐 키당 분당 30회 한도를 넘지 않도록 간격을 두세요.
결과에 따른 다음 작업
published에서는 플랫폼 게시물 ID를 저장하세요. failed에서는 오류에 맞춰 권한·미디어·한도를 확인하세요. unknown은 자동 재발행하지 않습니다. 먼저 대상 플랫폼에서 게시 여부를 확인해야 중복 발행을 피할 수 있습니다.