apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
The State of
JSON Schema
🧔 Ben Hutton
💻 @relequestual on the internet
👨🚀 JSON Schema Specification Lead @ Postman!
👨💻 benhutton.me
🙌 opencollective.com/json-schema
🎤 apidays Interface 2021
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
Specify it,
and they will implement?
It wasn't great, but it was good enough!
Slide 5
Slide 5 text
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
How did we get here?
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
Better Serving the Community
🤔
- Limited Slack History (🤙?)
- Who "owns" JSON Schema?
- Unknown decisions
- Current documentation?
- How to use Slack?
- Other use cases?
- Is JSON Schema done yet?
💡
- GitHub Discussions
- Joining the OpenJS Foundation?
- Architecture Decision Records
- Updating learning resources! OAI
- Greetbot enabled!
- Vocabulary SIGs (Special Interest Groups)
- ...😅 soon?
Slide 11
Slide 11 text
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
Is JSON Schema "done" yet?
We need your feedback!
- Feedback on Dialects and Vocabularies to make pragmatic changes if required.
Discussions started for CodeGen and Database by vendors.
- Another look at `format`
- Did we get dynamic references right?
- Output format
Draft 2020-12 used by OpenAPI 3.1.
Processing model is "done" or mostly done. Vocabularies may be simplified.
Should we self publish or publish through a standards org?
Slide 12
Slide 12 text
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
Working on a
"patch" release
https://github.com/json-schema-org/json-schema-
spec/milestone/9
Slide 13
Slide 13 text
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
Beyond the spec?
- Tests format revamp
- Linter
- Educational resources
- Audit of Implementations
- Guidelines and best practices
- Case Studies
Slide 14
Slide 14 text
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
Where do I go?
Slide 15
Slide 15 text
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
Where to go
Basics: json-schema.org/learn
More info: json-schema.org/understanding-json-schema
Playgrounds:
jsonschema.dev (draft-07 only for now)
json-schema.hyperjump.io (04 – 2020-12)
Help: stackoverflow.com (and tag with `jsonschema`)
Community:json-schema.org/slack
Twitter: @jsonschema
Elevating the community: github.com/json-schema-org/community
Slide 16
Slide 16 text
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
Thank you all
• Previous and current team
• Contributors and community
• Implementation developers
Pictures thanks to @bit_loom
Slide 17
Slide 17 text
apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
The State of JSON Schema
Thank you sponsors!
AsyncAPI Initiative
🧔 Ben Hutton
💻 @relequestual on the internet
👨🚀 JSON Schema Specification Lead @ Postman!
👨💻 benhutton.me
🙌 opencollective.com/json-schema
🎤 apidays Interface 2021
Retool
Stoplight
apideck