Abkündigung der REST APIs

Geschrieben von Waldemar Axt

Zuletzt aktualisiert Vor 3 Tagen

Unsere bisherigen REST APIs werden derzeit durch eine moderne GraphQL API ersetzt. Diese Seite fasst den aktuellen Stand, die Abkündigungstermine und die wichtigen Übergangsregelungen zusammen.

Verfügbare REST APIs

  • v1 API – erreichbar unter /api

  • v2 API – erreichbar unter /api/v2

Die REST APIs v1 und v2 werden zum 28. Februar 2027 abgekündigt.
Ab diesem Datum stehen diese Schnittstellen nicht mehr zur Verfügung.
Bitte plane frühzeitig den Umstieg auf die neue 123erfasst GraphQL API.

Nachfolge: 123erfasst GraphQL API

Unsere GraphQL API steht ab sofort als moderne, leistungsfähige und einheitliche Schnittstelle zur Verfügung.

Die GraphQL API ersetzt die bisherigen REST-Endpunkte vollständig und bietet flexible Datenabfragen über ein einziges Schema.
Sie ist bereits seit längerem aktiv und kann produktiv genutzt werden.

Ausnahmen bei der v2 API

Einige Pfade der v2 API sind nicht von der Abkündigung betroffen und bleiben vorerst bestehen.

Alle Pfade unterhalb der folgenden Pfade bleiben weiterhin erhalten

  • GET | /api/v2/images

  • GET | /api/v2/master/files

  • GET | /api/v2/files/

Solltest du in dieser Auflistung Pfade vermissen, melde dich bitte bei unserem Support, damit wir diese prüfen und ggf. in dieser Liste ergänzen können.

Empfehlungen für Entwickler

  • Implementiere neue Funktionen direkt auf Basis der GraphQL API und melde dich bei unserem Support, wenn dort Funktionalitäten fehlen.

  • Beginne rechtzeitig mit der Migration auf die GraphQL API.

  • Prüfe alle bestehenden Integrationen, die REST-Endpunkte verwenden.

  • Nutze die GraphQL Dokumentation und das graphiQL-Tool für deine Tests und Entwicklungsarbeit.