JSON-Verträge
Einheitliche Responses und maschinenlesbare Schemas.
Enterprise API · OpenAPI 3.1
Reisedaten, die sich prüfen lassen.
Prüfen Sie den vorbereiteten, versionierten Vertrag für Emissionsfaktoren, aggregierte Planungskennzahlen und signierte Trip Carbon Passports vor dem API-Launch.
Redaktioneller Stand
OPENAPI 3.1OpenAPI herunterladen
Die API ist zum Website-Start noch nicht öffentlich erreichbar. Vertrag und Endpunkte sind dokumentiert; Download und Live-Explorer werden mit dem API-Launch aktiviert.
01
01 · Schnellstart
Eine Integration vorbereiten.
Public v1 bleibt bewusst einfach: HTTPS, JSON, keine SDK-Abhängigkeit und keine Zugangsdaten für Open-Data-Operationen.
Kein Public API Key
Lesende Daten- und Verifizierungsaufrufe sind zugangsfrei.
Signierte Nachweise
Prüfung der HMAC-Integrität eines Berechnungsstands, nicht einer tatsächlichen Fahrt.
cURL
curl https://farleda.eu/api/public/v1/modes.json02
02 · API Explorer
Prüfen Sie den vorbereiteten Vertrag.
Wählen Sie eine dokumentierte Operation und prüfen Sie Request und cURL-Beispiel. Live-Anfragen und Demo-Passports werden mit dem API-Launch aktiviert.
Public-v1-Endpunkte
GET/api/public/v1
API-Übersicht
Funktionen, Lizenz und Betriebsregeln.
cURL
curl https://farleda.eu/api/public/v1Response
Nach API-Freigabe erscheint hier die Antwort einer gesendeten Anfrage.03
03 · Betrieb
Vorhersehbar per Design.
Der öffentliche Vertrag ist für Integrations-Governance, Edge-Caching und deterministische Verifizierung gebaut.
Authentifizierung
Public-v1-Daten und Passport-Verifizierung benötigen keine Zugangsdaten. Private Enterprise-Zugänge und Mandantentrennung sind vor einer Integration gesondert zu vereinbaren und zu prüfen.
Rate Limits
Gecachte GET-Daten haben kein anwendungsseitiges Limit. Demo-Ausgabe und Verifizierung sind auf 60 Anfragen pro IP und Stunde begrenzt.
Caching
Datenendpunkte liefern explizite Shared-Cache-Regeln. Passport-Endpunkte verwenden no-store.
Fehler
Transportfehler verwenden HTTP-Statuscodes. Eine gültige Verifizierungsanfrage liefert HTTP 200 und meldet die Signaturgültigkeit über valid.
04 · Governance
Ein Vertrag, den Ihr Review-Team prüfen kann.
- Breaking Changes erfordern einen neuen Major-API-Pfad.
- Jede Faktor-Antwort trägt Quellen- und Methodik-Kontext.
- Die OpenAPI-Datei ist der kanonische maschinenlesbare Vertrag.
- Aggregierte Zähler sind keine nachgewiesene Umweltwirkung. Kleine Gruppen und mögliche Rückschlüsse benötigen vor Veröffentlichung eine eigene Datenschutzprüfung.
