# 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](https://passport.kabin.sh/docs/de/quickstart).

## Öffentliche Pässe

[**Signatur offline prüfen**](https://passport.kabin.sh/docs/de/guides/verify-signature): Das öffentliche Dokument kanonisieren, den Hash vergleichen und die Ed25519-Signatur mit dem veröffentlichten
Schlüssel prüfen.

[**QR-Code auflösen**](https://passport.kabin.sh/docs/de/guides/resolve-digital-link): Vom gescannten GS1 Digital Link zum öffentlichen Pass-JSON, oder per GTIN und Seriennummer nachschlagen.

## Daten lesen

[**Einheiten abgleichen**](https://passport.kabin.sh/docs/de/guides/sync-units): Einheiten seitenweise mit dem Cursor übernehmen, nach einer Unterbrechung fortsetzen und Änderungen erkennen.

[**Pässe exportieren**](https://passport.kabin.sh/docs/de/guides/export-passports): BatteryPass-JSON, PDF und QR-Code einer Passversion sowie die Einheiten als Tabelle.

## Daten melden

[**Zustandsdaten senden**](https://passport.kabin.sh/docs/de/guides/push-condition-data): Messwerte aus einem Batteriemanagementsystem mit `updateCondition` melden.

[**Lebenszyklus-Ereignisse erfassen**](https://passport.kabin.sh/docs/de/guides/record-lifecycle-events): Inspektionen, Reparaturen und andere Ereignisse einer Einheit melden und ihren Lebenszyklus lesen.

## Im Betrieb

[**Fehler und Wiederholungen**](https://passport.kabin.sh/docs/de/guides/handle-errors): Welche Antworten Sie wiederholen, Backoff mit Jitter und was ins Log gehört.

[**Schlüssel sicher verwalten**](https://passport.kabin.sh/docs/de/guides/secure-key-handling): 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](https://passport.kabin.sh/docs/de/recipes) sind kurze, lauffähige Programme für
häufige Aufgaben.