# Änderungen

> Was sich an der Integrations-API und an dieser Dokumentation geändert hat.

Neue Einträge stehen oben. Den Verlauf gibt es auch als [RSS-Feed](https://passport.kabin.sh/docs/de/changelog/rss.xml).

## 0.10.0

_24.10.2026 · API · Vertrag · Integrationen_

Integrationen können jetzt Einheiten einbringen und Änderungen verfolgen, ohne alles abzusuchen.

- Ein dritter Schlüssel-Scope, `import`: Ein Schlüssel damit lädt Tabellenimporte von Einheiten hoch, ordnet sie zu
  und lässt sie prüfen ([`createImport`](https://passport.kabin.sh/docs/de/api-reference/imports/create-import),
  [`getImport`](https://passport.kabin.sh/docs/de/api-reference/imports/get-import), [`listImports`](https://passport.kabin.sh/docs/de/api-reference/imports/list-imports),
  [`updateImportMapping`](https://passport.kabin.sh/docs/de/api-reference/imports/update-import-mapping),
  [`validateImport`](https://passport.kabin.sh/docs/de/api-reference/imports/validate-import)). Das Übernehmen des Imports und das Freigeben
  seiner Werte bleiben bei Mitgliedern im Portal. Ein mit Schlüssel bereitgestellter Import nennt ihn in
  `created_by_api_key`; `created_by` fehlt dann.
- Importvorlagen: `preset` bei `createImport` und `updateImportMapping` ordnet die Spalten eines bekannten
  ERP-Exports über ihre Spaltennamen zu.
- Der Änderungsfeed [`listChanges`](https://passport.kabin.sh/docs/de/api-reference/changes/list-changes) (Scope `read`): die Änderungen der
  Organisation, älteste zuerst, ohne Werte, Handelnde oder personenbezogene Daten, sicher mit gespeichertem Cursor
  abzufragen.
- Neue [Integrationsanleitungen](https://passport.kabin.sh/docs/de/integrations): das Sicherheitsmodell, fünf Abläufe, iPaaS, Standards und
  eine Seite je ERP-System aus dem ERP-Register, mit Angabe, wie und wann jede Schnittstelle geprüft wurde.

## Entwicklerdokumentation

_24.10.2026 · Dokumentation_

Die Entwicklerdokumentation zieht unter `/docs/` um und ersetzt die bisherige Seite `/api-docs` (die auf die
API-Referenz weiterleitet).

- Erste Schritte, Konzepte, Anleitungen und Rezepte auf Deutsch und Englisch.
- Die API-Referenz wird aus dem veröffentlichten Vertrag erzeugt, mit Playground, Codebeispielen in cURL,
  JavaScript, Python und Go und dem Vertrag zum Herunterladen ([JSON](https://passport.kabin.sh/docs/openapi.json),
  [YAML](https://passport.kabin.sh/docs/openapi.yaml)).
- Jede Seite gibt es als Markdown (die Adresse der Seite plus `.md`), dazu
  [`llms.txt`](https://passport.kabin.sh/docs/llms.txt) und [`llms-full.txt`](https://passport.kabin.sh/docs/llms-full.txt) für Sprachmodelle.

## 0.9.0

_24.10.2026 · API · Vertrag_

Adressen folgen dem Format ihres europäischen Landes. Alle Änderungen sind kompatibel.

- `Address` erhält `extra_line` (die zweite Adresszeile: Gebäude, Etage, c/o) und `region` (die
  Verwaltungseinheit, wo das Adressformat des Landes eine hat). Beide sind optional und erscheinen in den
  Standorten von [`listFacilities`](https://passport.kabin.sh/docs/de/api-reference/facilities/list-facilities) und im öffentlichen Profil
  des Wirtschaftsakteurs in Pässen.
- `listFacilities` liefert außerdem `place_id` und `confirmed_source`: wie ein Mitglied die Adresse eingegeben hat
  (von Hand, aus der Adresssuche oder durch die Adressprüfung bestätigt). Beide stehen nie in signierten Snapshots
  oder öffentlichen Pässen.
- Der neue Problem-Code `address_lookup_unavailable` (`503`) gehört zur Adresssuche des Portals, die keine
  API-Schlüssel annimmt.

## 0.8.0

_24.10.2026 · API · Vertrag_

Veröffentlicht wird nur noch der Teil des Vertrags, den Integrationen nutzen können: die 32 Operationen, die
einen API-Schlüssel annehmen, und die 5 öffentlichen Pass-Abfragen. Anmeldung, Sitzungen, Schlüsselverwaltung
und alle anderen Operationen des Portals stehen nicht mehr in `/api/v1/openapi.json` und `.yaml`; sie können
sich ohne Ankündigung ändern.

- API-Schlüssel der Organisation (`Authorization: Bearer bp_live_…`) mit den Scopes `read` und `condition`.
  Inhaberinnen und Inhaber legen Schlüssel im Portal an; ein Schlüssel hat die Rechte eines Betrachters.
- Mit `condition` melden Batteriemanagementsysteme und Servicepartner Zustandsdaten (`updateCondition`) und
  Lebenszyklus-Ereignisse (`createLifecycleEvent`).
- Grenzen: 600 Anfragen pro Minute für alle Schlüssel einer Organisation zusammen, 30 Versuche je 15 Minuten
  für unbekannte Schlüssel, 300 öffentliche Abfragen pro Minute und Adresse; `429` mit `Retry-After`.