apicollective / apibuilder

Simple, Comprehensive Tooling for Modern APIs
https://www.apibuilder.io/
MIT License
562 stars 82 forks source link

[Experimental] Introduce templates into api.json format #898

Closed mbryzek closed 1 year ago

mbryzek commented 1 year ago

This PR introduces an experimental new features into the api.json spec - "templates".

Templates add support to api.json to create reusable definitions of
the various features in API Builder. As of the initial release, templates
are supported for both models and resources. Templates are syntactic sugar
in the api.json file format that copy portions of common specs into multiple
places. Templates require no changes in code generators (specifically because
there are no template related changes in the service specification itself).

Learn more in the Templates Docs