25
Juni
2018
in
vonJohannes Hoppe
DWX 2018:
API-Clients generieren mit Swagger und GraphQL
Welch ein Dilemma: Da baut man im Backend eine geniale REST-API – und dann wird sie im Frontend nicht korrekt genutzt. Oder die neuesten Änderungen werden nicht übernommen. Oder die falschen Typen werden verwendet… Die Lösung liegt auf der Hand: Menschen machen Fehler, Maschinen nicht. In diesem Vortrag zeige ich Ihnen, wie Sie Ihre API mithilfe von Swagger oder GraphQL beschreiben können.
Wir generieren automatisch einen passenden typsicheren Client per Code-Generator (swagger-codegen bzw. graphql-code-generator). Im konkreten Beispiel wird dies eine Angular-Anwendung mit dem HttpClient bzw. dem Apollo Client sein – auch hier können Sie die Beispiele auf andere Frameworks wie React anwenden.
In der abschließenden FAQ-Session besprechen wir die Unterschiede zwischen Swagger und GraphQL und klären, für welchen Anwendungsfall welches Framework besser geeignet ist.
- Slides (Google Docs)
- Demo code (Github)
- weiterführender Artikel: Generating Angular API clients with Swagger
- weiterführender Artikel: Swagger Codegen is now OpenAPI Generator
- weiterführender Artikel: Generating Angular API clients with Apollo and GraphQL code generator
Slide Deck