CocktailDB API JSON-Antwort in XML-Format konvertieren

Konvertieren der von der CocktailDB API empfangenen JSON-Daten in XML

Diese N8n Workflow-Vorlage wurde entwickelt, um zufällige Cocktail-Daten von der öffentlichen TheCocktailDB API im JSON-Format abzurufen und sie mithilfe der integrierten Daten transformationsfähigkeiten in das XML-Format zu konvertieren. Der Workflow demonstriert eine einfache, aber praktische Integrations- und Daten transformationspipeline, die sich ideal für Benutzer eignet, die JSON-Antworten von REST-APIs in XML für nachgelagerte Systeme umwandeln müssen, die XML-basierte Daten benötigen oder bevorzugen.

Was der Workflow tut

Der Workflow wird bei manueller Ausführung gestartet, sendet eine HTTP-GET-Anfrage, um die Details eines zufälligen Cocktails von der TheCocktailDB API abzurufen, und wandelt dann die zurückgegebene JSON-Antwort in ein XML-Dokument um. Dies ermöglicht eine nahtlose Interoperabilität zwischen modernen JSON-basierten APIs und älteren oder Unternehmenssystemen, die mit XML arbeiten.

Hauptmerkmale und Fähigkeiten

• Manuelle Trigger-Ausführung: Der Workflow wird nur bei manueller Auslösung ausgeführt und eignet sich daher für die Abfrage von Daten nach Bedarf.
• HTTP-Anfrage-Integration: Direkte Verbindung zu einer Live-öffentlichen REST-API ohne Authentifizierung.
• Datenformatkonvertierung: Verwendet den nativen XML-Knoten in n8n, um strukturiertes JSON in gut formatiertes XML zu konvertieren.
• Leichtgewichtig und wiederverwendbar: Die minimale Knoteneinrichtung macht diesen Workflow leicht verständlich, modifizierbar und in größeren Workflows wiederverwendbar.
• Keine externen Abhängigkeiten: Basiert ausschließlich auf den Kernknoten von n8n – Manual Trigger, HTTP Request und XML – und gewährleistet so die Kompatibilität über n8n-Umgebungen hinweg.

Hauptknoten und ihre Zwecke

1. Beim Klicken auf 'Ausführen' (Manual Trigger Node)

   • Zweck: Dient als Ausgangspunkt des Workflows.
   • Funktion: Wartet darauf, dass der Benutzer auf die Schaltfläche "Workflow ausführen" in der n8n-Oberfläche klickt, um den Prozess zu starten.
   • Typ: n8n-nodes-base/manualTrigger

2. HTTP Request Node

   • Zweck: Ruft Echtzeit-Cocktaildaten von einer externen API ab.
   • Funktion: Sendet eine GET-Anfrage an https://www.thecocktaildb.com/api/json/v1/1/random.php, die einen zufälligen Cocktail im JSON-Format zurückgibt (z. B. Name, Zutaten, Anweisungen, Bild).
   • Typ: n8n-nodes-base/httpRequest
   • Schlüsselparameter: URL auf den Zufallsdrink-Endpunkt von CocktailDB gesetzt.

3. XML Node

   • Zweck: Konvertiert die eingehende JSON-Nutzlast in das XML-Format.
   • Funktion: Arbeitet im Modus "jsonToXml" und wandelt die strukturierte JSON-Antwort der HTTP-Anfrage in eine gültige XML-Zeichenfolge um.
   • Typ: n8n-nodes-base/xml
   • Modus: jsonToxml – stellt die gerichtete Konvertierung von JSON zu XML sicher.

Anwendungsfälle und Vorteile

• Systemintegration: Nützlich bei der Integration mit Altsystemen oder Drittanbieter-Tools, die nur XML-Eingaben akzeptieren (z. B. ältere ERP-, CMS- oder EDI-Systeme).
• Datenstandardisierung: Ermöglicht die Standardisierung von Datenformaten in heterogenen Umgebungen.
• Prototyping & Testen: Ideal für Entwickler, die API-Antworten testen oder Proof-of-Concept-Integrationen mit Formatübersetzung erstellen.
• Lernwerkzeug: Hervorragend für Anfänger, die lernen, wie n8n API-Aufrufe und Datentransformationen handhabt.
• Vorbereitung zur Automatisierung: Kann erweitert werden, um automatisch über Webhooks oder Zeitpläne ausgelöst zu werden und konvertiertes XML in E-Mails, Dateispeicher oder Warteschlangen einzuspeisen.

Schritt-für-Schritt-Workflow-Logik

1. Schritt 1: Workflow-Initiierung

   • Der Benutzer führt den Workflow manuell aus, indem er auf die Schaltfläche "Ausführen" klickt.
   • Der Manual Trigger-Knoten wird aktiviert und übergibt die Kontrolle an den nächsten Knoten.

2. Schritt 2: Cocktail-Daten abrufen

   • Der HTTP Request-Knoten sendet eine GET-Anfrage an https://www.thecocktaildb.com/api/json/v1/1/random.php.
   • Die API antwortet mit einem JSON-Objekt, das Details zu einem zufällig ausgewählten Cocktail enthält, einschließlich seines Namens, seiner Zutaten, Maße, Anweisungen und mehr.

3. Schritt 3: JSON in XML konvertieren

   • Die JSON-Antwort wird an den XML-Knoten übergeben.
   • Der Knoten verarbeitet die JSON-Struktur und konvertiert sie in eine entsprechende XML-Darstellung.
   • Beispielsweise wird ein JSON-Feld wie {"strDrink": "Margarita"} zu <strDrink>Margarita</strDrink> innerhalb eines Root-Elements <root> (Standard, sofern nicht angepasst).

4. Ausgabe

   • Die endgültige Ausgabe ist eine formatierte XML-Zeichenfolge, die die ursprünglichen JSON-Daten widerspiegelt.
   • Dieses XML kann in nachfolgenden Knoten wie File Binary, Email oder Webhook Responders für weitere Verarbeitung oder Zustellung verwendet werden.

Dieser Workflow veranschaulicht die Stärke von n8n bei der Handhabung von API-Integrationen und Datentransformationen mit minimaler Konfiguration, wodurch er sowohl für technische als auch für nicht-technische Benutzer zugänglich ist.