array와 enum 제약

기본 패턴

{
  "type": "object",
  "properties": {
    "status": {
      "enum": ["draft", "review", "published"]
    },
    "tags": {
      "type": "array",
      "items": { "type": "string" }
    }
  }
}

설명

• array 검증에서는 items가 핵심입니다. 모든 항목이 어떤 schema를 따라야 하는지 지정할 수 있습니다.
• 위치별 의미가 다른 tuple 형태라면 prefixItems 같은 더 세밀한 구성이 필요할 수 있습니다.
• enum은 허용 가능한 값의 집합을 제한할 때 씁니다. 상태값, 종류, 코드 목록처럼 선택지가 정해진 데이터에 잘 맞습니다.
• const는 하나의 고정값만 허용할 때 쓰며, enum 하나짜리보다 의도가 더 분명합니다.
• array와 enum 제약을 함께 쓰면 "목록 항목의 타입"과 "허용 값의 범위"를 동시에 명확히 고정할 수 있습니다.

짧은 예제

{
  "type": "array",
  "items": {
    "enum": ["red", "green", "blue"]
  }
}

빠른 정리

주의할 점