Produkt-Highlight 

Content Delivery API - GraphQL

imx.Platform

Die offene API der imx.Platform stellt alle benötigten Dienste für die Nutzung und Integration der Daten durch Dritte bereit.

 | © Freepik
© Freepik

Blick ins Detail

Content Delivery  API (GraphQL)

  • API-Technologie in der imx.Platform

    Technologisch basiert die API zur imx.Platform auf GraphQL –  welche es erlaubt, sehr gezielte Anfragen und das gewünschte Antwortformat durch den API-Nutzer zu formulieren. Jede Anfrage erhält genau die Informationen als Antwort zurück, die im jeweiligen Kontext benötigt werden. Darauf aufbauend können fachlich APIs konstruiert werden – und nicht rein technisch getriebene Schnittstellen, wie sie häufig mit REST, HATEOAS oder einfach auch nur HTTP implementiert werden.

Auf einen Blick

Designziele

Die Content Delivery API (Graph QL) der imx.Platform verfolgt folgende Designziele:

  • Unterstützung beliebiger Nutzungsszenarien bzw. –kanäle in der Auslieferung von Inhalten z.B. direkte Client-2-Server Kommunikation
  • Hohe Performance, Skalierbarkeit und Resilienz
    • direkte Nutzung ohne zusätzlichen Wrapper möglich
  • Ermöglichung eines fachlicheren API-Design
  • Flexibles Antwortformat exakt für den jeweiligen Anwendungsfall
    • Effiziente Datenabfragen (Clients können genau spezifizieren)
  • Erleichterungen für API-Nutzer
    • Integration von impliziten Fachlogiken (z.B. Gültigkeit von Datensätzen, Datensatz-Sortierung)
    • Automatische Generierung von typisierten API-Clients

GraphQL

Vorteile

  • Vollständiges Datenschema

    Die Schnittstelle definiert für Ein-und Ausgabe ein vollständiges Datenschema. Dadurch wird zum Einen eine bestmögliche Unterstützung für API-Nutzer ermöglicht, z.B. durch Generierung von Datenmodell für API-Nutzer oder Autovervollständigung und zum Anderen die datengetriebene Weiterentwicklung der API sichergestellt.

  • Anwendungsfallorientierte Abfragen

    Mit GraphQL kann der Client genau die Daten anfordern, die benötigt werden, und zwar in der gewünschten Struktur. Dadurch werden Requests reduziert, die bei REST-APIs häufig auftreten.

  • Echtzeit-Daten mit Subscriptions:

    GraphQL unterstützt Subscriptions, die es ermöglichen, Echtzeit-Updates von Server zu Client zu empfangen. Dadurch wird Kommunikation in Echtzeit ermöglicht.

  • Flexiblität

    Die Technologie unterstützt die unterschiedliche Integration von anderen APIs. 

  • Nur ein Endpunkt

    Im Gegensatz zu REST, wo jede Ressource in der Regel einen eigenen Endpunkt hat, läuft bei GraphQL alles über einen einzigen Endpunkt. Die genaue Struktur und Menge der zurückgegebenen Daten wird durch die Abfrage definiert.

API & Graph QL

Infos & Links

Sie möchten noch mehr über die API und GraphQL in der imx.Platform erfahren? Vertiefen Sie hier Ihr Wissen:

Noch Fragen? 

Kontakt

Sie haben noch eine konkrete Frage dazu oder wollen die neue API für Ihr Projekt nutzen?
Gern tauschen wir uns dazu mit Ihnen aus!

Christian Heindl
Technischer Geschäftsführer
Telefon: +49 8641 6993-255