iPaaS und Middleware

Die meisten ERP-Integrationen laufen auf einer Integrationsplattform statt in eigenem Code. Jede Plattform unten kann BatteryPass aufrufen, denn die API braucht nur zwei Dinge: eine HTTPS-Anfrage mit dem Header Authorization: Bearer <Schlüssel> und JSON (oder multipart/form-data für Importe). Diese Seite zeigt, wo der Schlüssel auf jeder Plattform hingehört und wie jede dem Änderungsfeed folgt.

Die Plattformen sind nach ihrer öffentlichen Dokumentation beschrieben. BatteryPass bietet auf keiner davon einen eigenen Konnektor an und hat keine Partnerschaft mit ihren Herstellern.

Was alle Plattformen gleich machenLink zum Abschnitt kopieren

• Der Schlüssel liegt im Anmeldedatenspeicher der Plattform, nie in einer Flow-Definition, einem Skript oder einer Variablen, die in Ausführungsprotokollen erscheint. Ein Schlüssel je Flow und Umgebung (siehe Sicherheit).
• Der Vertrag. BatteryPass veröffentlicht seinen Integrationsvertrag als OpenAPI 3.0.3 unter /api/v1/openapi.json und /api/v1/openapi.yaml auf Ihrer BatteryPass-Adresse und zum Herunterladen in der API-Referenz. Plattformen, die OpenAPI 3 importieren, bauen daraus ihre Operationen.
• Abfragen statt Webhooks. Ausgehende Webhooks sendet BatteryPass noch nicht; sie sind geplant und brauchen eine eigene Entscheidung. Planen Sie einen Flow (alle paar Minuten), der GET /api/v1/changes mit dem gespeicherten Cursor aufruft, die Einträge der Reihe nach verarbeitet und next_cursor speichert, wenn er nicht null ist. Das Muster ist überall gleich:

cursor = aus dem Datenspeicher der Plattform laden (beim ersten Lauf leer)
wiederholen:
  GET /api/v1/changes?types=passport.published,passport.republished&limit=100&cursor={cursor}
  für jeden Eintrag: Entität lesen, ERP aktualisieren
  wenn next_cursor null ist: aufhören     (eine leere Seite behält den alten Cursor)
  cursor = next_cursor, speichern          (erst, nachdem das ERP die Seite angenommen hat)

• Fehler. 429 nach Retry-After und 5xx mit Backoff wiederholen, andere 4xx nicht (siehe Fehler und Wiederholungen behandeln).

PlattformenLink zum Abschnitt kopieren

Importe von einer Plattform hochladenLink zum Abschnitt kopieren

Einheiten aus der Fertigung braucht multipart/form-data: die Datei im Teil file (mit Dateiname und Inhaltstyp text/csv oder dem XLSX-Typ) und die Kennung der Importvorlage im Teil preset. Jede Plattform oben kann Multipart-Anfragen aus ihrem HTTP-Konnektor senden; bauen Sie die CSV im Flow und hängen Sie sie als binären Inhalt an. Fragen Sie danach GET /imports/{id} ab, bis status den Wert validated oder failed hat.