한국어

요청과 응답

HTTP 상태, 자료형이 있는 JSON 데이터, 요청 메타데이터를 함께 확인합니다.

요청

Content-Type: application/json: JSON 쓰기에는 Content-Type: application/json 을 보내세요.
data · meta: 성공 응답에는 data 와 meta 가 포함되고 컬렉션 응답에는 페이지 정보도 제공됩니다.
error.code · error.message: 오류에는 error.code, error.message 와 필요한 경우 필드 정보가 포함됩니다.

데이터 유형

필수 여부와 null 허용 여부는 별개입니다.
스키마가 허용하면 필수 필드도 null 을 포함할 수 있습니다.
JSON 불리언, 정수, 문자열, null 의 자료형을 강제 변환하지 마세요.
금액은 십진수 문자열입니다.
가격 계산에 이진 부동소수점을 사용하지 마세요.

64-bit · expected_version

일부 동시성 제어 버전은 부호 있는 64비트 정수입니다.
JavaScript 클라이언트는 Number.MAX_SAFE_INTEGER 를 초과하는 값을 손실 없이 JSON 으로 처리하고 원래 정수 표현으로 보내야 합니다.
버전을 반올림하거나 JSON 문자열로 바꾸지 마세요.

페이지 나누기

오류와 복구

헤더

Cache-Control문자열선택 사항: 응답 캐시 정책입니다.

const: "no-store"
X-Correlation-ID문자열선택 사항: 이 HTTP 요청을 추적하는 식별자입니다.
WWW-Authenticate문자열선택 사항: 서버가 요구하는 인증 방식입니다.
Allow문자열선택 사항: 이 리소스가 지원하는 HTTP 메서드입니다.
Retry-After정수선택 사항: 재시도 전에 기다려야 하는 최소 시간(초)입니다.

minimum: 0
Location문자열선택 사항: 생성된 리소스의 상대 URL입니다.