Anleitungen
Schritt-für-Schritt-Anleitungen für die häufigsten Aufgaben einer Integration, mit Anfragen, Antworten und den wichtigen Fehlerfällen.
Jede Anleitung führt eine Aufgabe von Anfang bis Ende durch: was Sie brauchen, die Anfragen in der richtigen
Reihenfolge, was zurückkommt und mit welchen Fehlern Sie rechnen sollten. Die Beispiele verwenden die
Umgebungsvariablen BATTERYPASS_URL und BATTERYPASS_API_KEY aus dem Schnellstart.
Öffentliche Pässe
Signatur offline prüfen
Das öffentliche Dokument kanonisieren, den Hash vergleichen und die Ed25519-Signatur mit dem veröffentlichten Schlüssel prüfen.
QR-Code auflösen
Vom gescannten GS1 Digital Link zum öffentlichen Pass-JSON, oder per GTIN und Seriennummer nachschlagen.
Daten lesen
Einheiten abgleichen
Einheiten seitenweise mit dem Cursor übernehmen, nach einer Unterbrechung fortsetzen und Änderungen erkennen.
Pässe exportieren
BatteryPass-JSON, PDF und QR-Code einer Passversion sowie die Einheiten als Tabelle.
Daten melden
Zustandsdaten senden
Messwerte aus einem Batteriemanagementsystem mit updateCondition melden.
Lebenszyklus-Ereignisse erfassen
Inspektionen, Reparaturen und andere Ereignisse einer Einheit melden und ihren Lebenszyklus lesen.
Im Betrieb
Fehler und Wiederholungen
Welche Antworten Sie wiederholen, Backoff mit Jitter und was ins Log gehört.
Schlüssel sicher verwalten
Wo Schlüssel liegen, welcher Scope für welches System, Wechsel ohne Ausfall und was nach einem Leck zu tun ist.
Sie suchen ein Skript zum Übernehmen? Die Rezepte sind kurze, lauffähige Programme für häufige Aufgaben.