API v1

Documentation API

L'API KolayCharge Compat fournit un accès programmatique aux données de compatibilité VE–borne.

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

Limitation de débit

60 requêtes par minute et par IP. En cas de dépassement, HTTP 429 est retourné.

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

Points de terminaison

GET /api/v1/vehicles/{slug}

Détail de la variante du véhicule

Paramètre	Dans	Description	Exemple
`slug`	path	Slug du véhicule	`tesla-model-y-2024-awd-eu`

Exemple de réponse

{ "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

Bornes compatibles pour le véhicule

Paramètre	Dans	Description	Exemple
`slug`	path	Slug du véhicule	`tesla-model-y-2024-awd-eu`

Exemple de réponse

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

GET /api/v1/chargers/{slug}

Détail du modèle de borne

Paramètre	Dans	Description	Exemple
`slug`	path	Slug de la borne	`abb-terra-360`

Exemple de réponse

{ "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

Véhicules compatibles pour la borne

Paramètre	Dans	Description	Exemple
`slug`	path	Slug de la borne	`abb-terra-360`

Exemple de réponse

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

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

Arête de compatibilité unique

Paramètre	Dans	Description	Exemple
`vehicleSlug`	path	Slug du véhicule	`tesla-model-y-2024-awd-eu`
`chargerSlug`	path	Slug de la borne	`abb-terra-360`
`region`	query	EU · TR · NA · GB	`EU`

Exemple de réponse

{ "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": [] }

États de compatibilité

state	Description
`ok`	Entièrement compatible
`adp`	Adaptateur requis
`limited`	Borne limitée
`no`	Incompatible
`unk`	Inconnu

Codes d'erreur

HTTP	Erreur	Description
400	`slugs_required`	Paramètre de chemin manquant
404	`not_found`	Ressource introuvable
429	`rate_limit_exceeded`	Limite de débit dépassée — attendre la réinitialisation