API v1

API Dokümantasyonu

KolayCharge Compat API, araç–şarj cihazı uyumluluk verilerine programatik erişim sağlar.

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

Hız Sınırı

Her IP için dakikada 60 istek. Aşıldığında 429 döner.

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

Endpoint'ler

GET /api/v1/vehicles/{slug}

Araç varyantı detayı

Parametre	Tür	Açıklama	Örnek
`slug`	path	Araç slug'ı	`tesla-model-y-2024-awd-eu`

Yanıt örneği

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

Araçla uyumlu charger'lar

Parametre	Tür	Açıklama	Örnek
`slug`	path	Araç slug'ı	`tesla-model-y-2024-awd-eu`

Yanıt örneği

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

GET /api/v1/chargers/{slug}

Şarj cihazı detayı

Parametre	Tür	Açıklama	Örnek
`slug`	path	Charger slug'ı	`abb-terra-360`

Yanıt örneği

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

Charger ile uyumlu araçlar

Parametre	Tür	Açıklama	Örnek
`slug`	path	Charger slug'ı	`abb-terra-360`

Yanıt örneği

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

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

Tek uyumluluk edge'i

Parametre	Tür	Açıklama	Örnek
`vehicleSlug`	path	Araç slug'ı	`tesla-model-y-2024-awd-eu`
`chargerSlug`	path	Charger slug'ı	`abb-terra-360`
`region`	query	EU · TR · NA · GB	`EU`

Yanıt örneği

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

Uyumluluk Durumları

state	Açıklama
`ok`	Tam uyumlu
`adp`	Adaptör gerekli
`limited`	Charger kısıtlı
`no`	Uyumsuz
`unk`	Bilinmiyor

Hata Kodları

HTTP	Hata	Açıklama
400	`slugs_required`	Eksik path parametresi
404	`not_found`	Kaynak bulunamadı
429	`rate_limit_exceeded`	Hız sınırı aşıldı