개발자 문서
오류 코드
원인과 해결 방법
오류 응답에는 변경되지 않는 영문 code와 한국어 message가 들어갑니다. 한도 위반에는 limit와 actual, 채널별 위반에는 platform을 확인하세요.
| 코드 | HTTP | 원인과 해결 방법 |
|---|---|---|
| unauthenticated | 401 | 로그인 또는 인증 정보가 없습니다. 로그인하거나 유효한 키를 넣어 주세요. |
| invalid_api_key | 401 | API 키가 올바르지 않습니다. 키를 확인해 주세요. |
| api_key_revoked | 401 | 폐기된 API 키입니다. 새 키를 발급해 주세요. |
| api_key_expired | 401 | API 키가 만료되었습니다. 새 키를 발급해 주세요. |
| verification_required | 403 | 인증이 끝나지 않았습니다. 가입한 이메일의 인증 링크를 열어 인증을 마쳐 주세요. |
| forbidden_scope | 403 | 이 작업을 할 권한이 없습니다. 필요한 권한을 승인해 주세요. |
| invalid_params | 400 | 입력값이 없거나 형식이 올바르지 않습니다. 값을 확인해 주세요. |
| workspace_required | 400 | 워크스페이스가 지정되지 않았습니다. 사용할 워크스페이스를 선택해 주세요. |
| validation_failed | 422 | 채널 규격에 맞지 않습니다. 내용을 고친 뒤 다시 검사해 주세요. |
| content_too_long | 422 | 글자수 한도를 넘었습니다. 문구를 줄여 주세요. |
| content_too_large | 422 | 본문의 바이트 한도를 넘었습니다. 문구를 줄여 주세요. |
| media_required | 422 | 이 채널에는 미디어가 필요합니다. 사진이나 영상을 추가해 주세요. |
| media_too_many | 422 | 미디어 개수 한도를 넘었습니다. 파일 수를 줄여 주세요. |
| media_mixed | 422 | 사진과 영상을 함께 올릴 수 없습니다. 한 종류만 선택해 주세요. |
| media_type_not_supported | 422 | 지원하지 않는 파일 형식입니다. 지원 형식으로 바꿔 주세요. |
| media_too_large | 422 | 파일 크기 한도를 넘었습니다. 더 작은 파일을 올려 주세요. |
| media_aspect_ratio | 422 | 사진 또는 영상 비율이 맞지 않습니다. 채널 규격에 맞는 파일을 올려 주세요. |
| media_width_out_of_range | 422 | 사진 너비가 채널 규격을 벗어났습니다. 규격에 맞게 크기를 바꿔 다시 올려 주세요. |
| media_too_short | 422 | 영상이 너무 짧습니다. 채널의 최소 길이에 맞는 영상을 올려 주세요. |
| media_too_long | 422 | 영상 길이 한도를 넘었습니다. 더 짧은 영상을 올려 주세요. |
| media_not_found | 404 | 미디어를 찾을 수 없습니다. 미디어 ID와 워크스페이스를 확인해 주세요. |
| media_not_ready | 422 | 미디어 업로드가 아직 끝나지 않았습니다. 완료 후 다시 시도해 주세요. |
| media_expired | 404 | 미디어 보관 기한이 지났습니다. 새 파일을 업로드해 새 글로 발행해 주세요. |
| media_file_invalid | 422 | 업로드한 파일이 손상됐거나 요청한 형식·크기와 다릅니다. 파일을 다시 확인해 주세요. |
| media_in_use | 409 | 이 파일은 글 또는 업로드 링크에서 사용 중입니다. 첨부를 해제하거나 글을 정리한 뒤 다시 시도해 주세요. |
| upload_link_invalid | 404 | 업로드 링크를 찾을 수 없습니다. 에이전트에게 새 링크를 요청해 주세요. |
| upload_link_expired | 410 | 업로드 링크의 30분 사용 시간이 지났습니다. 에이전트에게 새 링크를 요청해 주세요. |
| upload_link_full | 409 | 이 링크에 허용된 파일을 모두 올렸습니다. 더 올리려면 에이전트에게 새 링크를 요청해 주세요. |
| media_url_invalid | 422 | 미디어 주소가 올바른 HTTPS 주소가 아닙니다. 주소를 확인해 주세요. |
| media_url_blocked | 422 | 안전하지 않은 미디어 주소입니다. 공개 HTTPS 주소를 사용해 주세요. |
| media_url_unreachable | 422 | 미디어 주소에 연결할 수 없습니다. 주소와 접근 권한을 확인해 주세요. |
| scheduled_at_invalid | 422 | 예약 시각에 시간대가 없습니다. 시간대가 포함된 시각을 입력해 주세요. |
| scheduled_at_range | 422 | 예약 가능한 기간을 벗어났습니다. 예약 시각을 다시 선택해 주세요. |
| queue_slot_taken | 409 | 해당 예약 분에는 이미 큐 글이 있습니다. 다른 시각을 선택해 주세요. |
| queue_slot_rule_not_found | 404 | 큐 슬롯 규칙을 찾을 수 없습니다. 목록을 새로고침해 주세요. |
| queue_slot_rule_revoked | 409 | 폐기된 큐 슬롯 규칙은 바꿀 수 없습니다. 새 규칙을 만들어 주세요. |
| queue_slot_unavailable | 409 | 예약 가능한 큐 슬롯이 없습니다. 규칙과 기간을 확인해 주세요. |
| account_not_connected | 404 | 연결된 계정을 찾을 수 없습니다. 채널을 연결해 주세요. |
| account_has_active_work | 409 | 이 계정에 예약·발행·삭제 작업이 남아 있습니다. 작업을 완료하거나 예약 글을 수정·삭제한 뒤 다시 시도해 주세요. |
| account_expired | 422 | 채널 연결이 만료되었습니다. 다시 연결해 주세요. |
| account_restricted | 422 | 채널 계정이 제한되었습니다. 채널에서 제한 사유를 확인해 주세요. |
| platform_not_ready | 422 | 이 채널은 아직 발행할 수 없습니다. 가동 중인 채널을 선택해 주세요. |
| duplicate_post | 409 | 같은 글을 최근에 요청했습니다. 기존 글을 확인해 주세요. |
| idempotency_key_reused | 422 | 같은 요청 키에 다른 내용이 들어왔습니다. 새 요청 키를 사용해 주세요. |
| post_not_editable | 409 | 이 상태의 글은 수정할 수 없습니다. 임시 또는 예약 글을 선택해 주세요. |
| post_changed | 409 | 검사하는 동안 글이 바뀌었습니다. 새로고침한 뒤 다시 시도해 주세요. |
| post_not_found | 404 | 글을 찾을 수 없습니다. 글 ID와 워크스페이스를 확인해 주세요. |
| webhook_not_found | 404 | 웹훅 구독을 찾을 수 없습니다. ID와 워크스페이스를 확인해 주세요. |
| webhook_revoked | 409 | 폐기된 웹훅 구독은 바꿀 수 없습니다. 새 구독을 만들어 주세요. |
| webhook_delivery_not_found | 404 | 웹훅 전달 기록을 찾을 수 없습니다. ID와 워크스페이스를 확인해 주세요. |
| webhook_subscription_inactive | 409 | 웹훅 구독이 중지되거나 폐기됐습니다. 활성 구독에서 다시 시도해 주세요. |
| webhook_delivery_not_retryable | 409 | 확정 실패한 웹훅 전달만 다시 보낼 수 있습니다. 현재 상태를 확인해 주세요. |
| instagram_dm_backfill_not_found | 404 | 과거 댓글 준비 작업을 찾을 수 없습니다. 워크스페이스와 작업 목록을 확인해 주세요. |
| instagram_dm_backfill_conflict | 409 | 준비 작업의 상태나 요청 내용이 달라졌습니다. 결과를 새로고침하고 같은 요청을 확인해 주세요. |
| instagram_dm_rule_not_found | 404 | 댓글 자동화 규칙을 찾을 수 없습니다. 목록을 새로고침해 주세요. |
| instagram_dm_rule_not_editable | 409 | 이 규칙은 바로 고칠 수 없습니다. 사용 중이면 먼저 중지해 주세요. 폐기했다면 새 규칙을 만들어 주세요. |
| instagram_dm_not_approved | 409 | Instagram 댓글 자동화가 아직 승인되지 않았습니다. Meta 앱 심사와 시험을 마친 뒤 다시 켜 주세요. |
| instagram_dm_permission_missing | 409 | 연결된 Instagram 계정에 댓글 자동화 권한이 없습니다. 계정을 다시 연결하고 권한을 승인해 주세요. |
| instagram_comments_not_approved | 409 | Instagram 수동 댓글 관리가 아직 승인되지 않았습니다. Meta 앱 심사와 시험을 마친 뒤 다시 시도해 주세요. |
| instagram_comments_permission_missing | 409 | 연결된 Instagram 계정에 댓글 관리 권한이 없습니다. 계정을 다시 연결하고 권한을 승인해 주세요. |
| instagram_comment_not_found | 404 | 이 게시물의 댓글을 찾을 수 없습니다. 게시물과 댓글 ID를 확인해 주세요. |
| instagram_comment_not_replyable | 422 | 이 댓글에는 답글을 달 수 없습니다. 숨겨지지 않은 최상위 댓글을 선택해 주세요. |
| instagram_comment_provider_unavailable | 503 | Instagram에서 댓글을 확인할 수 없습니다. 잠시 뒤 다시 시도해 주세요. |
| instagram_comment_action_not_found | 404 | 댓글 작업을 찾을 수 없습니다. 작업 ID와 워크스페이스를 확인해 주세요. |
| publish_in_flight | 409 | 글을 발행하는 중입니다. 완료된 뒤 결과를 확인해 주세요. |
| nothing_to_retry | 422 | 다시 시도할 채널이 없습니다. 채널별 상태를 확인해 주세요. |
| quota_exceeded | 402 | 이번 달 발행 한도에 도달했습니다. 초기화 날짜를 확인하거나 요금제를 변경해 주세요. |
| rate_limited | 429 | 요청을 너무 자주 보냈습니다. 잠시 뒤 다시 시도해 주세요. |
| internal_error | 500 | 서버에 문제가 생겼습니다. 요청 ID와 함께 문의해 주세요. |