Tag: REST-API

1. API-First: Workflow zwischen Backend, Frontend und QA

   15.08.2025

   Wer APIs implementiert, bevor das Design steht, blockiert Frontend-Teams und zwingt QA-Ingenieure zu manuellem Nachfassen. API-First kehrt die Reihenfolge um: Die OpenAPI-Spezifikation entsteht zuerst, ermöglicht Mocking für Frontend und Contract-Tests für QA – alle Teams entwickeln parallel, ohne aufeinander zu warten.

   Read more

2. Webhooks in OpenAPI 3.1 dokumentieren

   15.08.2025

   Webhooks wurden jahrelang außerhalb der API-Dokumentation beschrieben – in separaten Markdown-Dateien, die niemand aktuell hält. OpenAPI 3.1 bringt das neue webhooks-Objekt, das Webhook-Payload-Schemas, Sicherheitsanforderungen und Retry-Verhalten direkt in der Spezifikation verankert.

   Read more

3. Contract-Testing für REST-APIs mit OpenAPI

   31.07.2025

   Eine OpenAPI-Spezifikation, die nicht mehr mit der Implementierung übereinstimmt, ist schlechter als gar keine Dokumentation – sie täuscht. Contract-Testing schließt diese Lücke automatisch: Tests prüfen bei jedem Commit, ob die Backend-Implementierung noch dem Vertrag entspricht, den die Spezifikation definiert.

   Read more

4. Pagination, Filter und Sortierung in REST APIs sauber entwerfen

   21.07.2025

   List-Endpoints sind die komplexesten Teile einer REST API: Sie müssen Pagination, Filterung und Sortierung konsistent unterstützen, ohne die API-Oberfläche aufzublasen. Der Unterschied zwischen einem gut und einem schlecht entworfenen List-Endpoint liegt in drei Entscheidungen: Cursor oder Offset, welche Filterparameter erlaubt, und wie das Meta-Objekt die Konsumenten informiert.

   Read more

5. REST und GraphQL in PHPStorm testen: HTTP-Client, Environments und Variables

   25.06.2025

   Der PHPStorm HTTP-Client ersetzt Postman für viele Entwickler vollständig: .http-Dateien versioniert im Repo, Environments für dev/staging/prod, Variables für Tokens und IDs, Response-Handler für automatische Assertions. Für Magento-REST und GraphQL gibt es spezifische Patterns, die das Testen erheblich einfacher machen.

   Read more

6. OpenAPI und Security Audits: Was Prüfer wirklich sehen wollen

   20.06.2025

   Security-Prüfer öffnen ein OpenAPI-Dokument mit einer klaren Checkliste im Kopf: Sind alle Endpoints authentifiziert? Sind Fehlerresponses vollständig dokumentiert? Werden Eingaben validiert? Wer diese Perspektive kennt, baut API-Dokumentation, die Audits beschleunigt, Findings reduziert und Vertrauen schafft.

   Read more

7. OpenAPI Codegen: Clients und Server-Stubs ohne Müll erzeugen

   17.06.2025

   Code-Generierung aus OpenAPI-Spezifikationen klingt verlockend, produziert in der Praxis aber oft unlesbaren Müll, der sofort manuell gepatcht werden muss. Das zerstört den Hauptvorteil der Generierung. Dieser Artikel zeigt, wie man openapi-generator so konfiguriert, dass der Ausgabecode wartbar ist – und warum Template-Overrides der Schlüssel dazu sind.

   Read more

8. OpenAPI Security Schemes praktisch verstehen

   14.06.2025

   Eine REST-API ohne korrekt dokumentierte Sicherheitsanforderungen ist für Konsumenten eine Blackbox. OpenAPI 3.x bietet vier Security-Scheme-Typen, die sich in der Swagger-UI direkt nutzbar machen lassen – wenn man weiß, wie man sie korrekt modelliert, global und endpoint-spezifisch kombiniert und mit Scopes granular steuert.

   Read more

9. OpenAPI Generator in CI einbauen: Client-SDKs und Stubs automatisch generieren

   08.06.2025

   Manuell aus einer OpenAPI-Spec Client-SDKs zu generieren ist fehleranfällig und blockiert Releases. Der openapi-generator in einer CI/CD-Pipeline generiert, validiert und veröffentlicht SDKs automatisch bei jeder Spec-Änderung – mit Spectral-Linting, Breaking-Change-Detection und Contract-Tests als Gates.

   Read more

10. Error-Payloads und Business-Errors in OpenAPI richtig modellieren

    22.05.2025

    Fehlermodellierung ist der vernachlässigte Teil des API-Designs. RFC 9457 Problem Details, domänenspezifische Fehlercodes und polymorphe Fehlerschemas machen den Unterschied zwischen einer API, bei der Integratoren raten müssen, was ein Fehler bedeutet, und einer API, bei der Fehler selbsterklärend und maschinell verarbeitbar sind.

    Read more