데이터 스키마: 속성과 값

데이터 스키마: 속성과 값. API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

데이터 스키마

조회 — 속성과 값 — 응답

ApiResponse_FeatureData_ · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

dataFeatureData 필수: 응답 예제 · FeatureData.

예제: {"created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","position":1,"updated_at":"2026-01-01T12:00:00Z","version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta 필수: 응답 메타데이터입니다.

예제: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

추가 필드: 아니요

조회 · 값 — 속성과 값 — 응답

ApiResponse_FeatureValueData_ · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

dataFeatureValueData 필수: 응답 예제 · FeatureValueData.

예제: {"created_at":"2026-01-01T12:00:00Z","feature_id":"example","id":"example","number":"example","position":1,"updated_at":"2026-01-01T12:00:00Z","value":"example","version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta 필수: 응답 메타데이터입니다.

예제: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

추가 필드: 아니요

목록 조회 — 속성과 값 — 응답

ApiResponse_list_FeatureData__ · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

data배열 <FeatureData > 필수: 응답 예제 · ApiResponse_list_FeatureData__.

예제: [{"created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","position":1,"updated_at":"2026-01-01T12:00:00Z","version":1}]
metaContextPageMeta ContextMeta PageMeta RequestMeta 필수: 응답 메타데이터입니다.

예제: {"locale":"en","market_code":"PL","market_id":"example","pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

추가 필드: 아니요

목록 조회 · 값 — 속성과 값 — 응답

ApiResponse_list_FeatureValueData__ · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

data배열 <FeatureValueData > 필수: 응답 예제 · ApiResponse_list_FeatureValueData__.

예제: [{"created_at":"2026-01-01T12:00:00Z","feature_id":"example","id":"example","number":"example","position":1,"updated_at":"2026-01-01T12:00:00Z","value":"example","version":1}]
metaContextPageMeta ContextMeta PageMeta RequestMeta 필수: 응답 메타데이터입니다.

예제: {"locale":"en","market_code":"PL","market_id":"example","pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

추가 필드: 아니요

생성 — 속성과 값 — 요청 본문

FeatureCreate · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

name문자열필수

해당 컨텍스트의 리소스 이름입니다.

minLength: 1maxLength: 120

제약 조건

pattern: "^[^\\x00]*$"

예제: "Example"

position정수선택 사항

정렬된 컬렉션에서의 위치입니다.

minimum: 0maximum: 2147483647

추가 필드: 아니요

조회 — 속성과 값 — 응답

FeatureData · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

created_at문자열필수: 생성 시각입니다.

format: "date-time"

예제: "2026-01-01T12:00:00Z"
id문자열필수: 리소스 식별자이며 반환된 값을 그대로 유지해야 합니다. (FeatureData).

예제: "example"
name문자열 null필수: 해당 컨텍스트의 리소스 이름입니다.

예제: "Example"
number문자열필수: 사용자에게 표시하는 주문 또는 요청 번호입니다.

예제: "example"
position정수필수: 정렬된 컬렉션에서의 위치입니다.

예제: 1
updated_at문자열필수: 가장 최근 업데이트 시각입니다.

format: "date-time"

예제: "2026-01-01T12:00:00Z"
version정수필수: 동시성 제어에 사용하는 리소스 버전입니다.

예제: 1

추가 필드: 아니요

상품 속성입니다

FeatureSelectionData · 스키마 · 데이터 스키마: 속성과 값

feature_id문자열필수: 속성 식별자입니다.

예제: "example"
feature_name문자열 null필수: 속성 이름입니다.

예제: "example"
value문자열 null필수: 주변 스키마에서 설명하는 값입니다.

예제: "example"
value_id문자열필수: 사전 값 식별자입니다.

예제: "example"

추가 필드: 아니요

수정 — 속성과 값 — 요청 본문

FeatureUpdate · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

expected_version정수필수

쓰기 전에 읽은 버전이며 일치하지 않으면 업데이트가 거부됩니다.

minimum: 1maximum: 9223372036854775807

예제: 1

name문자열 null선택 사항

해당 컨텍스트의 리소스 이름입니다.

문자열:minLength: 1maxLength: 120

제약 조건 · 문자열 1

pattern: "^[^\\x00]*$"

예제: "Example"

position정수선택 사항

정렬된 컬렉션에서의 위치입니다.

minimum: 0maximum: 2147483647

추가 필드: 아니요

생성 · 값 — 속성과 값 — 요청 본문

FeatureValueCreate · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

expected_version정수필수

쓰기 전에 읽은 버전이며 일치하지 않으면 업데이트가 거부됩니다.

minimum: 1maximum: 9223372036854775807

예제: 1

position정수선택 사항

정렬된 컬렉션에서의 위치입니다.

minimum: 0maximum: 2147483647

value문자열필수

주변 스키마에서 설명하는 값입니다.

minLength: 1maxLength: 180

제약 조건

pattern: "^[^\\x00]*$"

예제: "Example"

추가 필드: 아니요

조회 · 값 — 속성과 값 — 응답

FeatureValueData · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

created_at문자열필수: 생성 시각입니다.

format: "date-time"

예제: "2026-01-01T12:00:00Z"
feature_id문자열필수: 속성 식별자입니다.

예제: "example"
id문자열필수: 리소스 식별자이며 반환된 값을 그대로 유지해야 합니다. (FeatureValueData).

예제: "example"
number문자열필수: 사용자에게 표시하는 주문 또는 요청 번호입니다.

예제: "example"
position정수필수: 정렬된 컬렉션에서의 위치입니다.

예제: 1
updated_at문자열필수: 가장 최근 업데이트 시각입니다.

format: "date-time"

예제: "2026-01-01T12:00:00Z"
value문자열 null필수: 주변 스키마에서 설명하는 값입니다.

예제: "example"
version정수필수: 동시성 제어에 사용하는 리소스 버전입니다.

예제: 1

추가 필드: 아니요

수정 · 값 — 속성과 값 — 요청 본문

FeatureValueUpdate · API가 받거나 반환하는 데이터의 필드, 유형 및 제약 조건입니다.

expected_version정수필수

쓰기 전에 읽은 버전이며 일치하지 않으면 업데이트가 거부됩니다.

minimum: 1maximum: 9223372036854775807

예제: 1

position정수선택 사항

정렬된 컬렉션에서의 위치입니다.

minimum: 0maximum: 2147483647

value문자열 null선택 사항

주변 스키마에서 설명하는 값입니다.

문자열:minLength: 1maxLength: 180

제약 조건 · 문자열 1

pattern: "^[^\\x00]*$"

예제: "Example"

추가 필드: 아니요