JSON Schema-validator

Verktøyet støtter JSON Schema Draft-07, Draft 2019-09 og Draft 2020-12 via Ajv-biblioteket. De vanligste schema-funksjonene støttes.

Ja! JSON Schema støtter dypt nøstede objekter og arrayer. Du kan definere properties og items på ethvert nøstingsnivå, med egne valideringsregler for hvert felt.

Verktøyet validerer først at schemaet ditt i seg selv er gyldig JSON Schema. Hvis schemaet har feil, rapporteres de før verktøyet forsøker å validere dataene.

type (string, number, object, array, boolean, null), properties med nestede schemaer, required som lister obligatoriske nøkler, enum for faste verdismengder, pattern for regex-begrensede strenger, og områdekontrollene minimum/maximum og minLength/maxLength. additionalProperties: false strammer inn objekter mot ekstra nøkler. Til sammen dekker de hoveddelen av API-valideringsregler.

I moderne JSON Schema er format en annotasjon som standard, ikke en automatisk assertasjon - validatorer håndhever den bare når de er konfigurert for det, noe 2020-12-spesifikasjonen gjorde eksplisitt med et separat format-assertion-vokabular. Bruk pattern eller et egendefinert nøkkelord når håndheving må garanteres, og behold format som interoperabilitets-metadata ellers.

$ref som peker på #/$defs/address refererer til et schema-fragment under $defs og validerer mot det der det brukes - dette er dedupliseringsmekanismen. Draft 2020-12 ga den eldre definitions det nye navnet $defs og formaliserte $dynamicRef for rekursive strukturer som kommentartrær. Referanser kan også peke på eksterne dokumenter, men å buntle dem lokalt er vanligere.

allOf krever at hvert delschema validerer - et snitt, brukt til å komponere et basis-schema med ekstra begrensninger. anyOf krever minst ett - en union, brukt for polymorfe payloads. oneOf krever nøyaktig ett; at to eller null delschemaer validerer feiler, noe som er strengere enn folk forventer og den vanlige årsaken til overraskende feil med overlappende schemaer.

2020-12 delte spesifikasjonen i separat forhandlingsbare vokabularer (validation, annotation, format-assertion), gav definitions det nye navnet $defs, forenklet exclusiveMinimum til et vanlig tall, og erstattet det eldre items-nøkkelordet med prefixItems pluss items. Mesteparten av verktøykjeden støtter begge; draft-07 er fortsatt mest utbredt, men 2020-12 er den gjeldende publiserte standarden.