OpenApi and JSON Schema

• OpenApi
  • Model
  • Schema objects
  • XML objects
• https://github.com/openapi-contrib/openapi-schema-to-json-schema
• https://github.com/openapi-contrib/json-schema-to-openapi-schema
• npm package swagger-cli
  • can be used to merge (bundle) a bunch of openapi specs

• Data types in OpenApi are based on the types in JSON Schema
• JSON Schema vs OAS' "schema" https://swagger.io/docs/specification/data-models/keywords/
• Web Services Description Language (WSDL)

• Regexes in JSON Schema are ECMA-262 (a.k.a. ECMAScript a.k.a. JavaScript) regular expression
• Date and time format names are derived from RFC 3339, section 5.6.
  • IIUC, this is ISO 8601
• Duration format is from the ISO 8601 ABNF as given in Appendix A of RFC 3339.
• There are 5 categories of keywords
  • identifiers
  • assertions
  • annotations
  • applicators
  • reserved locations

• OpenApi specification (OAS)
• JSON Schema spefification
• Internationalized Resource Identifiers (IRIs)
• Uniform Resource Identifier (URI)
• Base16, Base32, and Base64 Data Encodings
• Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types

As of 2024-06-07,

• the latest version of JSON Schema Specification is 2020-12
• the latest version of OpenApi Specification is 3.1.0

• Clojure spec library
• Web Services Description Language (WSDL)