Gate97Docs
Registrieren

Eigene Connectoren

Wenn die benötigte App nicht in der Connector-Referenz ist, definieren Sie stattdessen einen eigenen Connector — verweisen Sie Gate97 auf Ihre eigene (oder eine beliebige) HTTP-API und nutzen Sie sie als Aktionsschritt in jedem Workflow. Eigene Connectoren sind privat für Ihre Organisation; niemand außerhalb kann einen von Ihnen definierten sehen oder nutzen.

Einen definieren

Auf der Seite Eigene Apps benötigt ein eigener Connector:

  • Name — wie er überall im Dashboard erscheint, einschließlich der Connector-Auswahl im Workflow-Builder.
  • Basis-URL — die Wurzel der API, z. B. https://api.example.com.
  • Auth-Typ — none, API key (als von Ihnen benannter Header gesendet), bearer-Token, oder basic (Benutzername + Passwort).
  • Standard-Anfrage-/Antwortformat — JSON, XML, CSV, oder reiner text. Gate97 serialisiert ausgehende Bodies und parst eingehende Antworten in dem Format, das die API tatsächlich spricht, sodass ein Workflow-Schritt Felder auch bei einer XML- oder CSV-API normal zuordnen kann.

Einmal definiert, erscheint er auf der Seite Verbindungen wie jede integrierte App — verbinden Sie ihn mit den vom Auth-Typ geforderten Zugangsdaten (oder nichts, bei none).

Verwendung in einem Workflow

Ein eigener Connector hat eine Aktion, verfügbar im Workflow-Builder, sobald Sie ihn als Connector eines Schritts auswählen:

  • Methode — GET, POST, PUT, PATCH oder DELETE.
  • Pfad — an die Basis-URL angehängt, template-fähig, z. B. /orders?status={{trigger.status}}.
  • Header — ein template-fähiges JSON-Objekt zusätzlicher Header.
  • Body — template-fähiges JSON, vor dem Senden in das konfigurierte Übertragungsformat (XML/CSV/Text) umgewandelt.
  • Anfrage-/Antwortformat — vorausgefüllt aus den Standardwerten des Connectors, pro Schritt überschreibbar.

Daten empfangen (eingehender Trigger)

Ein eigener Connector kann optional auch eingehende Daten akzeptieren — aktivieren Sie Unterstützt eingehenden Trigger bei der Definition und wählen Sie das Format, in dem der Absender POST oder PUT sendet. Sobald ein damit genutzter Workflow aktiv ist, zeigt sein Trigger-Schritt eine echte Webhook-URL, gesichert durch ein nicht erratbares Token, das in die URL selbst eingebettet ist, statt eines gemeinsamen Geheimnisses. Alles dorthin Gesendete wird gemäß Ihrem gewählten Format geparst und startet einen Durchlauf — siehe Webhooks für die vollständige Funktionsweise, die mit Stripes integriertem Webhook-Trigger geteilt wird.

SAP Business One, Pantheon ERP und WordPress

Diese drei Connectoren erscheinen vorbenannt auf der Seite Verbindungen, funktionieren darunter aber anders. SAP Business One spricht direkt mit der echten Login-/Sitzungs-API seiner Service Layer. Pantheon ERP und WordPress sind funktional vorbenannte eigene Connectoren — Sie geben die URL und Zugangsdaten Ihres eigenen Servers an und erstellen dann selbst die genaue Anfrage im Workflow-Schritt, genau wie bei jedem eigenen Connector — da jede Installation dieser Systeme unterschiedlich genug konfiguriert ist, dass keine einzelne fest codierte Integration für alle funktionieren würde.