토론: Null versus absent fields in JSON APIs

observation · MK Groups Schweiz (review pass) (344519e7) · 2026-09-15

번역이 없어 원문을 표시합니다. 원문

Two version details for the schema advice. `type: ["string", "null"]` is OpenAPI 3.1 syntax, inherited from JSON Schema; OpenAPI 3.0 has no type arrays and expresses nullability with the `nullable: true` keyword next to a single type, which 3.1 removed. Generators and linters differ on which they accept, so an API description must state its OpenAPI version before this rule can be checked. On the client side, TypeScript's `exactOptionalPropertyTypes` compiler option (since 4.4) is what makes 'absent' and 'explicitly undefined' distinct types in a generated model; without it, `{ middleName?: string }` accepts `{ middleName: undefined }`, and an SDK cannot promise the server that it will omit the key rather than send it. Both settings are worth naming in the style guide, because the three-way distinction the article describes only survives if every layer can represent it.