API Dokümantasyonu

Kimlik Doğrulama

Tüm API istekleri bir API anahtarı ile kimlik doğrulaması gerekir. Anahtarınızı hesap ayarlarından alabilirsiniz.

API anahtarınızı asla paylaşmayın. Public uygulamalar için OAuth 2.0 kullanın.

cURL Örneği

curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.ureticy.com/v1/stations

JavaScript / Fetch Örneği

const response = await fetch('https://api.ureticy.com/v1/stations', { headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' } });

API Uç Noktaları

Temel URL

https://api.ureticy.com/v1

İçerik Türleri

application/json
application/x-www-form-urlencoded

Hız Sınırı

API istekleri dakika başına 100 istekle sınırlandırılmıştır. Limit aşılırsa HTTP 429 hatası döner.

İstasyonları Yönetme

İstasyonları Listele

GET/stations

Parametre	Tür	Açıklama
`page`	integer	Sayfa numarası (varsayılan: 1)
`limit`	integer	Sayfa başı kayıt (maks: 100)
`status`	string	active \| inactive \| error

Başarı Yanıtı

{"status":"success","data":{"stations":[{"id":"station_123","name":"İstanbul-01","status":"active","connector_count":2}],"pagination":{"page":1,"total":48}}}

Şarj Başlat

POST/stations/{id}/start

Parametre	Zorunlu	Açıklama
`connector_id`	Evet	Konnektör ID
`user_id`	Evet	Kullanıcı ID

İşlemler

GET/transactions

Parametre	Örnek
`station_id`	station_123
`date_from`	2026-01-01
`date_to`	2026-04-18

Webhooks

Önemli olaylar hakkında gerçek zamanlı bildirim alın.

Desteklenen Olaylar

station.connected
station.disconnected
transaction.started
transaction.completed
error.critical

Örnek Payload

{ "event": "transaction.completed", "timestamp": "2026-04-18T10:30:00Z", "data": { "transaction_id": "txn_789", "station_id": "station_123", "energy_consumed": 15.5, "duration_minutes": 45, "amount": 82.50 } }

Hata Kodları

Kod	Açıklama
`400`	Hatalı istek — parametre hatası
`401`	Yetkisiz — API anahtarı gerekli
`403`	Yasak — yeterli izin yok
`404`	Bulunamadı — kaynak mevcut değil
`429`	Çok fazla istek — rate limit aşıldı
`500`	Sunucu hatası

Hata Yanıtı Örneği

HTTP 401 Unauthorized

{"status":"error","error":{"code":"INVALID_API_KEY","message":"The provided API key is invalid or expired.","timestamp":"2026-04-18T10:30:00Z"}}