Slide 1

Slide 1 text

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

Slide 2

Slide 2 text

apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman JSON Schema?

Slide 3

Slide 3 text

apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman JSON Schema!

Slide 4

Slide 4 text

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?

Slide 6

Slide 6 text

apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman Drafts?

Slide 7

Slide 7 text

apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman Focus on validation Acknowledging other use cases

Slide 8

Slide 8 text

apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman Postman Open Technologies 🎉 Partnering with JSON Schema 🎉

Slide 9

Slide 9 text

apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman Elevating JSON Schema

Slide 10

Slide 10 text

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