In writing about Workflow (then) and Shortcuts (now) for a living, at some point I realized that if I wanted to build more complex shortcuts to either deal with web APIs or store data in iCloud Drive, ...
If you're building a RESTful Web service, you can provide both guidance and control around the JSON messages your service works with by replacing documentation with JSON Schemas. Say what you want ...
JSON is a hugely popular format, used for configuration, API responses, game save data, and much more. But it has its critics, and JSON is not the only option. YAML is actually older than JSON, but ...