Forwarding you to blog.heroku.com

Saved by the Schema: Using JSON Schema to Document, Test, and Debug APIs | Heroku

Heroku has many public API endpoints. Each of these endpoints needs to be tested so that we know how they work, and documented so that our customers (and other API consumers) know how they work. Follow along, and well learn how Heroku uses JSON Schema to test and document our Platform API and how it helped us uncover an unexpected bug, rooted in the way the Oj gem parses Big Decimals.