Today we’re making an important piece of Platform API tooling available: A machine-readable JSON schema that describes what resources are available via the API, what their URLs are, how they are represented and what operations they support. The schema opens up many interesting use cases, both for users and for us at Heroku working on improving and extending the API. A few examples are:
- Auto-creating client libraries for your favorite programming language
- Generating up-to-date reference docs
- Writing automatic acceptance and integration tests
We are already using the schema to maintain the API reference documentation on Dev Center and to generate several v3 client libraries:
- Heroics for...