Neue Sandbox für die doo GraphQL-Schnittstelle

Mit dem heutigen Release der Produkt-Check-in Funktion für das doo Einlassmanagement führen wir auf http://gql.doo.net eine aktualisierte Explorer-Oberfläche für unsere GraphQL-Schnittstelle ein.

Die bisherige Playground-Oberfläche wird ersetzt, da sie die neuen oneOf-Queries nicht unterstützt, die mit dem neuen Feature eingeführt werden, und außerdem bekannte Darstellungsprobleme bei Tooltips hat.

Die neue Sandbox dient der Untersuchung der GraphQL-Schnittstelle. Nutzer können dort den Code für Datenabfragen via GraphQL oder für den benutzerdefinierten Payload von Webhooks entwickeln und testen. Außerdem finden Sie dort die vollständige Schema-Dokumentation in einer leicht veränderten Darstellung. Für den eigentlichen Schnittstellen-Endpoint graphQL.doo.net ändert sich nichts.

Was ändert sich inhaltlich am Schema?

• Das “Product”-Objekt wird erweitert und künftig (parallel zur Ticket-Query) als eigene Query verfügbar sein.

• Analog zur bestehenden Logik bei Tickets und Ticketkategorien, wird zwischen “Product” und “Product Category” unterschieden. “Product” bezeichnet dabei ein konkret gebuchtes Product mit einen eigenen Hash für den Check-in. “Product Category” beschreibt die Produktdefinition, wie Name, Preis oder Kapazität, also die Informationen, die Sie im dritten Schritt der Veranstaltungserstellung eingeben.

• Zusätzlich stellen wir neue Mutations für Check-in und Undo Check-in bereit – sowohl für Tickets als auch für Produkte. Für Tickets wird dafür eine V2 eingeführt. Diese Version empfehlen wir ausdrücklich für alle zukünftigen Implementierungen.

Kompatibilität und Empfehlungen

Für bestehende Implementierungen besteht kein akuter Handlungsbedarf – sie werden weiterhin funktionieren, da die Änderungen abwärtskompatibel sind. Einige Felder werden als “deprecated” markiert. Sie werden vorerst weiterhin unterstützt, jedoch nicht mehr upgedated. Für neue Implementierungen sollten die als “deprecated” markierten Datenfelder nicht mehr verwendet werden, sondern die in der jeweiligen Beschreibung angegebenen alternativen Felder.

Wenn Sie bereits GQL-Queries mit Products verwenden, empfehlen wir, diese schrittweise zu überprüfen und perspektivisch anzupassen.

Alle Informationen, welche Möglichkeiten Sie bei doo mit GraphQL haben, finden Sie in unserer technischen GraphQL-Dokumentation.