Änderungen

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, getImport, listImports, updateImportMapping, validateImport). 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 (Scope read): die Änderungen der Organisation, älteste zuerst, ohne Werte, Handelnde oder personenbezogene Daten, sicher mit gespeichertem Cursor abzufragen.
• Neue Integrationsanleitungen: 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.

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, YAML).
• Jede Seite gibt es als Markdown (die Adresse der Seite plus .md), dazu llms.txt und llms-full.txt für Sprachmodelle.

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 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.

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.