JSON 스키마 생성기

추론이 잘하는 것

• 타입: string, number, integer, boolean, null, array, object.
• null 허용 여부: 한 샘플에서는 null이고 다른 샘플에서는 문자열인 필드는 ["string", "null"]이 됩니다.
• 배열 항목: 동질적인 배열은 단일 items 스키마를, 이질적인 배열은 prefixItems를 생성합니다.
• 열거형(enum): 관찰된 모든 값이 작은 집합에 속하면(설정 가능, 기본값 10개의 서로 다른 값) enum을 출력합니다.
• 필수: 샘플이 여러 개면 키의 교집합이 required가 되고, 샘플이 하나면 옵트아웃하지 않는 한 모든 키가 필수입니다.
• 포맷: ISO-8601 날짜, 이메일, URI와 일치하는 문자열에는 format이 추론됩니다.

추론이 알 수 없는 것

• 의도와 예시의 차이: 샘플 age: 25에서는 type: integer가 추론되지만, null도 허용하는지는 알 수 없습니다. 엣지 케이스를 포함하는 여러 샘플을 제공하세요.
• 제약 조건: minLength, maximum, pattern 등은 직접 추가해야 합니다. 추론은 샘플에서 한계값을 추측하지 않습니다.
• 비즈니스 로직: “이 세 필드 중 정확히 하나만 설정해야 한다”와 같은 조건에는 oneOf가 필요하며, 추론할 수 없습니다.
• 참조: 생성기는 평면적인 스키마를 출력합니다. 반복되는 형태를 $defs로 분리하려면 생성 후에 처리하세요.

출력 예시

단일 샘플로부터:

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

추론된 스키마(draft 2020-12):

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

흔한 실수

• 하나의 샘플만으로 추론하기. 스키마가 과적합되어 모든 필드가 필수가 되고 null 허용이 사라집니다. 항상 5~10개의 다양한 샘플을 입력하세요.
• number를 의도했는데 integer를 사용하기. 어떤 샘플에 소수가 있으면 추론된 타입은 number가 되고, 모두 정수면 integer가 됩니다. 둘 다 가능한 필드에는 소수를 포함한 샘플을 넣으세요.
• 선택 필드를 놓치기. 5개 중 4개에 있고 1개에서 빠진 필드는 선택 필드가 됩니다(의도된 동작). 만약 5개 모두에 우연히 포함되면, 실제로는 API에서 선택 필드여도 스키마는 이를 필수로 표시합니다.