API v1

Documentación API

La API KolayCharge Compat proporciona acceso programático a los datos de compatibilidad VE–cargador.

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

Límite de tasa

60 solicitudes por minuto por IP. Si se supera, se devuelve HTTP 429.

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

Endpoints

GET /api/v1/vehicles/{slug}

Detalle de variante de vehículo

Parámetro	En	Descripción	Ejemplo
`slug`	path	Slug del vehículo	`tesla-model-y-2024-awd-eu`

Ejemplo de respuesta

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

Cargadores compatibles para el vehículo

Parámetro	En	Descripción	Ejemplo
`slug`	path	Slug del vehículo	`tesla-model-y-2024-awd-eu`

Ejemplo de respuesta

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

GET /api/v1/chargers/{slug}

Detalle del modelo de cargador

Parámetro	En	Descripción	Ejemplo
`slug`	path	Slug del cargador	`abb-terra-360`

Ejemplo de respuesta

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

Vehículos compatibles para el cargador

Parámetro	En	Descripción	Ejemplo
`slug`	path	Slug del cargador	`abb-terra-360`

Ejemplo de respuesta

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

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

Arista de compatibilidad única

Parámetro	En	Descripción	Ejemplo
`vehicleSlug`	path	Slug del vehículo	`tesla-model-y-2024-awd-eu`
`chargerSlug`	path	Slug del cargador	`abb-terra-360`
`region`	query	EU · TR · NA · GB	`EU`

Ejemplo de respuesta

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

Estados de compatibilidad

state	Descripción
`ok`	Totalmente compatible
`adp`	Adaptador requerido
`limited`	Cargador limitado
`no`	Incompatible
`unk`	Desconocido

Códigos de error

HTTP	Error	Descripción
400	`slugs_required`	Parámetro de ruta faltante
404	`not_found`	Recurso no encontrado
429	`rate_limit_exceeded`	Límite de tasa superado — espera el reinicio