API v1

API-Dokumentation

Die KolayCharge Compat API bietet programmatischen Zugriff auf EV-Ladestation-Kompatibilitätsdaten.

Base URL: /api/v1 Rate limit: 60 req/min Format: JSON Auth: none (public beta)

Ratenbegrenzung

60 Anfragen pro Minute und IP. Bei Überschreitung wird HTTP 429 zurückgegeben.

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1748476800

Endpunkte

GET /api/v1/vehicles/{slug}

Fahrzeugvariante Details

Parameter	In	Beschreibung	Beispiel
`slug`	path	Fahrzeug-Slug	`tesla-model-y-2024-awd-eu`

Antwortbeispiel

{ "id": "uuid", "slug": "...", "brand": "Tesla", "family": "Model Y",
  "max_dc_kw_oem": 250, "battery_kwh_usable": 75.0,
  "architecture_voltage_v": 400, "bidirectional": [] }

GET /api/v1/vehicles/{slug}/compatibility

Kompatible Ladestationen für Fahrzeug

Parameter	In	Beschreibung	Beispiel
`slug`	path	Fahrzeug-Slug	`tesla-model-y-2024-awd-eu`

Antwortbeispiel

{ "slug": "tesla-model-y-2024-awd-eu", "chargers": [...] }

GET /api/v1/chargers/{slug}

Ladestation Modell Details

Parameter	In	Beschreibung	Beispiel
`slug`	path	Ladestation-Slug	`abb-terra-360`

Antwortbeispiel

{ "id": "uuid", "slug": "abb-terra-360", "brand": "ABB",
  "nominal_max_kw": 360, "current_kind": "DC",
  "output_voltage_min_v": 150, "output_voltage_max_v": 920 }

GET /api/v1/chargers/{slug}/compatibility

Kompatible Fahrzeuge für Ladestation

Parameter	In	Beschreibung	Beispiel
`slug`	path	Ladestation-Slug	`abb-terra-360`

Antwortbeispiel

{ "slug": "abb-terra-360", "vehicles": [...] }

GET /api/v1/compatibility/{vehicleSlug}/{chargerSlug}

Einzelne Kompatibilitätskante

Parameter	In	Beschreibung	Beispiel
`vehicleSlug`	path	Fahrzeug-Slug	`tesla-model-y-2024-awd-eu`
`chargerSlug`	path	Ladestation-Slug	`abb-terra-360`
`region`	query	EU · TR · NA · GB	`EU`

Antwortbeispiel

{ "vehicle": "tesla-model-y-2024-awd-eu", "charger": "abb-terra-360",
  "region": "EU", "kw": 250, "state": "ok",
  "confidence": 0.75, "adapterRequired": false,
  "protocols": ["iso-15118-2"], "edgeVersion": 1,
  "derivationVersion": "graph-linker-v1",
  "createdAt": "2026-05-21", "sources": [] }

Kompatibilitätszustände

state	Beschreibung
`ok`	Vollständig kompatibel
`adp`	Adapter erforderlich
`limited`	Ladestation-begrenzt
`no`	Nicht kompatibel
`unk`	Unbekannt

Fehlercodes

HTTP	Fehler	Beschreibung
400	`slugs_required`	Fehlender Pfadparameter
404	`not_found`	Ressource nicht gefunden
429	`rate_limit_exceeded`	Ratenlimit überschritten — auf Zurücksetzen warten