요청과 응답

요청 규칙

• JSON 본문에는 Content-Type: application/json을 사용합니다. 문서의 필드 이름과 enum 대소문자는 그대로 유지하세요.
• 알 수 없는 요청 필드는 422로 거절됩니다. 응답에는 새 필드가 추가될 수 있으므로 모르는 응답 필드를 무시하세요.
• Kits-Idempotency-Key는 해당 API가 필수라고 선언한 경우에 사용합니다. 요청 본문이나 작업을 바꾸고 기존 키를 재사용하지 마세요.
• Kits-Request-Id는 추적을 위한 값이며 중복 발송 방지 키가 아닙니다. 서버 응답의 요청 식별자를 진단용으로 보관하세요.
• v1a는 ETag/If-Match 기반 변경을 제공하지 않습니다. 각 작업에 정의된 expected_* 값과 충돌 응답을 따르세요.

권한만 확인하는 읽기 예제

아래는 인증이 필요한 enum 레지스트리 조회입니다. 네트워크 접근과 인증 확인용이며 푸시 서비스 연결이나 기기 수신을 검증하지 않습니다.

curl --include \
  --header "Authorization: Bearer ${KITS_SERVER_KEY}" \
  "${KITS_API_ORIGIN}/v1/registry/enums"

성공과 부분 결과

메시지 접수·푸시 서비스 처리·기기 확인은 별도 단계입니다. 각 응답의 상태, 집계값, ignored_fields와 페이지 정보를 읽으세요. 상태를 모르는 결과를 성공이나 실패로 임의 변환하지 마세요.

정확한 요청·응답 구조

API 레퍼런스는 저장소의 공개 OpenAPI와 엔드포인트 계약에서 생성됩니다. 필수 입력, 선택 필드, 타입·범위, 인증 대안과 응답별 JSON Schema를 확인할 수 있습니다. 계약에 없는 성공 본문은 임의로 만들어 표시하지 않습니다.