Gate97
Registrieren

Eigene Apps

Wenn die benötigte App nicht in der Integrationen-Liste steht, definieren Sie stattdessen eine eigene App — verweisen Sie Gate97 auf Ihre eigene (oder eine beliebige) HTTP-API und nutzen Sie sie als Schritt in jedem Roboter. Eigene Apps sind privat für Ihre Organisation; niemand außerhalb kann eine von Ihnen definierte sehen oder nutzen.

Eine definieren

Auf der Seite Eigene Apps benötigt eine eigene App:

  • Name — wie sie überall im Dashboard erscheint, einschließlich der Integrationsauswahl im Roboter-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 Roboter-Schritt Felder auch bei einer XML- oder CSV-API normal zuordnen kann.

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

Verwendung in einem Roboter

Eine eigene App hat eine Aktion, verfügbar im Roboter-Builder, sobald Sie sie als Integration 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 der eigenen App, pro Schritt überschreibbar.

Daten empfangen (eingehender Trigger)

Eine eigene App 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 Roboter, der sie nutzt, bei der Arbeit 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 Integrationen 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 Apps — Sie geben die URL und Zugangsdaten Ihres eigenen Servers an und erstellen dann selbst die genaue Anfrage im Roboter-Schritt, genau wie bei jeder eigenen App — da jede Installation dieser Systeme unterschiedlich genug konfiguriert ist, dass keine einzelne fest codierte Integration für alle funktionieren würde.