한계 및 오류

이 페이지에는 API 전체에서 공유되는 규칙이 요약되어 있습니다. 필수 필드, 수명 주기 동작 및 모델별 의미 체계는 여전히 각 API 페이지에 속합니다.

공유 한도

아이템	한도
신체 사이즈 요청	최대 32KB.
게이트웨이 생성 ID	32개의 소문자 16진수 문자입니다.
Channel 비밀번호	일반적으로 8~128자입니다.
`op_id`	1~128자; 문자, 숫자, `_`, `:`, `-`.
`thing_id` / `event_id`	1-64자; 문자, 숫자, `_`, `:`, `-`.
`images`	최대 32개의 URL, 각각 최대 2048자.
`tags`	최대 32개의 태그(각각 최대 64자)를 잘라내고 중복을 제거했습니다.
`metadata`	scalar 값만 허용합니다. key 최대 64, 비어 있지 않은 scalar value 최대 512. 중첩 object와 array는 허용되지 않습니다.
`attrs`	object patch입니다. `null`은 key를 삭제합니다. array와 깊은 중첩은 거부됩니다.
`ttl` 및 API timestamp	문서화된 필드는 Unix 초 또는 밀리초를 허용하며 밀리초로 정규화합니다.
알 수 없는 필드	기본 Message, Event, Thing 및 MCP 도구 인수는 엄격합니다. 알 수 없는 필드가 400을 반환합니다.

성공:

{
  "success": true,
  "data": {
    "accepted": true
  },
  "error": null,
  "error_code": null
}

실패:

{
  "success": false,
  "data": null,
  "error": "human readable message",
  "error_code": "machine_readable_code"
}

자동화는 자연어 error 텍스트보다 success 및 error_code를 선호해야 합니다.

success=true는 Gateway가 요청을 처리했음을 의미합니다. accepted=true는 발송에 들어갔다는 뜻입니다.

다음 사항을 보장하지 않습니다.

accepted를 최종 디바이스 디스플레이 영수증이 아닌 Gateway 수락 및 발송 상태로 처리합니다.

상태	의미	일반적인 이유	해야 할 일
`200`	Gateway가 요청을 처리했습니다	`success=true`, 하지만 여전히 `accepted`를 확인하세요	반환된 ID와 `op_id`를 저장합니다.
`400`	유효성 검사 실패	필수 필드 누락, 알 수 없는 필드, 잘못된 형식	JSON를 API 필드 테이블과 비교하세요.
`401`	Gateway 인증 실패	개인용 Gateway는 `PUSHGO_TOKEN`를 사용합니다. Bearer 토큰이 없거나 잘못됨	`Authorization: Bearer <token>`를 확인하세요.
`404`	타겟 누락	Channel, Event 또는 Thing이 존재하지 않습니다	`channel_id`, `event_id`, `thing_id`를 확인하세요.
`413`	요청 본문이 너무 큼	JSON가 32KB를 초과합니다	이미지 URL을 사용하세요. 메타데이터 또는 속성을 줄입니다.
`503`	발송이 완전히 허용되지 않음	공급자, private transport, 대기열 또는 다운스트림을 사용할 수 없음	Gateway 로그, 통계, 대기열 용량을 검사합니다.