Tag: REST-API

1. Idempotenz und Retry bei POST, PUT, PATCH und DELETE

   27.04.2026

   Netzwerkfehler passieren. Timeouts passieren. Was passiert, wenn ein Client eine Anfrage wiederholt, weil er keine Antwort bekommen hat? Bei idempotenten Methoden: nichts Schlimmes. Bei POST: möglicherweise eine Doppelbuchung, ein doppelter Datensatz oder eine zweifache Zahlung. Dieser Artikel erklärt, wie man REST-APIs so gestaltet, dass Retries sicher sind.

   Read more

2. Symfony REST API von Grund auf: Controller, DTOs, Serializer, Validator, Error Handling

   26.04.2026

   Eine produktionsreife Symfony REST API entsteht nicht durch das Zusammenstecken einzelner Komponenten – sie erfordert eine klare Architektur, die alle Teile konsistent verbindet: Request-Deserialisierung, Validierung, Business-Logik, Response-Serialisierung und einheitliches Error Handling. Dieser Guide zeigt den vollständigen Aufbau mit Symfony 7 und PHP 8.4.

   Read more

3. OpenAPI Beispiele und Schemas in Symfony konsistent pflegen

   24.04.2026

   Dokumentation, die vom Code abweicht, ist schlimmer als gar keine Dokumentation. Wer OpenAPI-Schemas, Validierungsregeln und Beispielwerte in Symfony nicht strukturiert pflegt, baut technische Schulden auf, die sich bei jedem Breaking Change entladen. Dieser Artikel zeigt, wie man Schemas, Beispiele und Validierung dauerhaft synchron hält.

   Read more

4. Magento GraphQL & REST Endpoints mit PhpStorm HTTP-Client testen

   21.04.2026

   Postman, Insomnia und curl haben ausgedient, wenn PhpStorm einen vollwertigen HTTP-Client eingebaut hat. GraphQL-Queries, REST-Endpoints, Bearer-Token-Authentifizierung und Environment-Variablen für verschiedene Stages – alles direkt in der IDE, versioniert im Repository und ohne Tool-Wechsel.

   Read more

5. OpenAPI in Symfony mit NelmioApiDocBundle sauber aufsetzen

   15.04.2026

   Wer eine Symfony-REST-API ohne Dokumentation betreibt, überlässt Konsumenten und QA-Teams die mühsame Reverse-Engineering-Arbeit. NelmioApiDocBundle generiert aus PHP-Attributes und YAML-Konfiguration eine vollständige OpenAPI 3.1-Spezifikation – inklusive Swagger-UI, JWT-Security-Schemes und Response-Schemas direkt aus dem Code.

   Read more

6. Webhooks vs. Polling vs. REST Callbacks – wann was?

   24.03.2026

   Nicht jede asynchrone Anforderung braucht Webhooks. Polling ist manchmal die richtigere Wahl. Und REST Callbacks existieren als Hybridansatz, den viele nicht kennen. Wer den Unterschied versteht, trifft bessere Architekturentscheidungen – und baut keine Webhook-Infrastruktur auf, wo ein einfaches 30-Sekunden-Polling die sauberere Lösung wäre.

   Read more

7. Backward Compatibility in API-Schemas technisch absichern

   08.03.2026

   Ein Breaking Change in einer REST-API ist kein Versionsproblem – es ist ein Vertragsproblem. Wenn Konsumenten sich auf ein Schema verlassen und der Provider es still verändert, entstehen Produktionsausfälle ohne Vorwarnung. Technische Absicherung bedeutet: Breaking Changes automatisch erkennen, Deprecation-Zyklen durchsetzen und Consumer-Driven Contract Tests als strukturelles Sicherheitsnetz einzusetzen.

   Read more

8. HATEOAS: Pragmatisches REST und wann Hypermedia wirklich Sinn ergibt

   06.03.2026

   HATEOAS ist das Prinzip, das REST von einem einfachen HTTP-Datentransport trennt – und gleichzeitig das meistdiskutierte und seltenst umgesetzte REST-Constraint. Dieser Artikel erklärt, was Hypermedia wirklich bedeutet, welche Formate sich bewährt haben und wann der Pragmatismus über die Reinheit geht.

   Read more

9. REST-API-Dokumentation für externe Integratoren schreiben, die wirklich hilft

   25.02.2026

   Gute API-Dokumentation ist nicht das, was automatisch aus OpenAPI-Kommentaren generiert wird. Sie ist das, was einen externen Entwickler befähigt, in 15 Minuten den ersten erfolgreichen API-Call zu machen und danach selbstständig weiter zu integrieren – ohne Support-Ticket.

   Read more

10. OpenAPI Mock-Server für Frontend-Entwicklung aufsetzen

    17.02.2026

    Frontend-Teams, die auf fertige Backend-Endpunkte warten, verschwenden Entwicklungszeit. Ein Mock-Server aus der OpenAPI-Spec liefert in Minuten realistische API-Antworten — inklusive Fehlerszenarien, Netzwerklatenz-Simulation und automatischer Validierung aller Requests gegen die Spec.

    Read more