16:15 - 17:00
The contract first approach is a way of designing and developing API’s starting from a contract. Using the openAPI convention you can design your API and share it with your consumers and developers. This approach has the following advantages:
- Easy integration: Your developers and your consumers get used to the same contract to build their software so the integration will be very smooth.
- Easy alignment and discussions: All the discussion that happens around the API with the consumers will be based on the contract, using tools like Swagger editor will give a nice rendering of the contract and make it easy to enrich it.
- Versioning: The contract will have a version and this will ensure an easy evolvement of your API.
On the development side, we have today a plugin that helps developers to generate the model (and many other classes) to kickoff their development. The generated model will ensure that the JSON response sent back to the consumer is what was agreed in the contract. There is also a plugin that could generate the documentation using Redoc. In a nutshell: using this approach will decrease the time to market of your API’s.