Upgrade to Pro — share decks privately, control downloads, hide ads and more …

API first development with OpenAPI: you should practice it !?

API first development with OpenAPI: you should practice it !?

API First development, should you practise it? Of course.
In this lightning talk I'll show you how OpenAPI can make your life easier in a serverless world:

- creating the contract with your consumers is the first thing that you do
- you can automatically create your API from this OpenAPI definitions when using cloud(eg. skip the whole configuration of your API Gateway on AWS by using OpenAPI)
- automatically generate your java class definitions based on this OpenAPI definitions
- automatically generate Spring Contracts from your OpenAPI definitions
- you’ll have a beautiful visual overview of your API
- validate incoming and outgoing requests with the OpenAPI definition

Did you notice that I just gave you six advantages of using OpenAPI? It’s only the beginning. And that’s why you should practice API First development with OpenAPI.

Nick Van Hoof

November 07, 2019
Tweet

More Decks by Nick Van Hoof

Other Decks in Programming

Transcript

  1. 2 § Nick Van Hoof § Cloud Developer § Ordina

    § https://ordina-jworks.github.io/author/nick-van-hoof § https://nickvanhoof.com Whoami
  2. 3 § Open API à functional § Open API in

    practice à technical Content § No demo’s § Movies § Valuable info bit.ly/31IJZTH
  3. 5

  4. 14 § API first development § Open API § Open

    API in practice - Creating API compliant code - Integrating with build process - Creating your API gateway - Testing your api Content
  5. 20 § API first development § Open API § Open

    API in practice - Creating API compliant code - Integrating with build process - Creating your API gateway - Testing your API Content
  6. 25 § API first development § Open API § Open

    API in practice - Creating API compliant code - Integrating with build process - Creating your API gateway - Testing your API § Wrapping up Content
  7. 26 API FIRST DEVELOPMENT WITH OPEN API § Wait with

    development until API definition is finished § Little extra documentation can be added in the API specs § Be careful with code generation
  8. 27 API FIRST DEVELOPMENT WITH OPEN API § Clear API

    definition § Teams can work separately § Strong consistency between web layer and API spec § API compliant code § Strong tooling support