Die OpenAPI-Werkzeugkiste: Qualität und Automatisierung durch Open Source Tools

OpenAPI-Dokumente sind häufig qualitativ schlecht und weichen schnell von der realen API ab. Es gibt jedoch eine Vielzahl an Open-Source-Tools, die Entwickler:innen das Leben erleichtern und die Qualität der Dokumentation und der API steigern können.

In meinem Vortrage erzähle ich euch wie ihr OpenAPI Tools für die Automatisierung in der CI/CD Pipeline einsetzen könnt und zeige euch live die folgenden Tools:

• Mocking mit Stoplight Prism
  
• Validierung mit Stoplight Spectral und Vacuum
  
• Formatting mit openapi-format
  
• Contract Testing mit portman und newman
  

Mit meinem GitHub-Playground als Starthilfe könnt ihr die Tools danach sehr einfach auch mit euren eigenen APIs ausprobieren.

Vorkenntnisse

Grundlegendes Wissen zu OpenAPI

Lernziele

• Kennenlernen verschiedener OpenAPI-Tools
  
• Best Practices zur Nutzung der vorgestellten Tools
  
• Verstehen von Ansätzen, die auch zur Automatisierung in der CI/CD-Pipeline genutzt werden können