API-Dokumentation

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem API-Schlüssel. Ihren Schlüssel finden Sie in den Kontoeinstellungen.

Geben Sie Ihren API-Schlüssel niemals weiter. Verwenden Sie OAuth 2.0 für öffentliche Anwendungen.

cURL-Beispiel

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

JavaScript / Fetch-Beispiel

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

API-Endpunkte

Basis-URL

https://api.ureticy.com/v1

Inhaltstypen

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

Ratenbegrenzung

API-Anfragen sind auf 100 pro Minute begrenzt. Bei Überschreitung erhalten Sie HTTP 429.

Stationen verwalten

Stationen auflisten

GET/stations

Parameter	Typ	Beschreibung
`page`	integer	Seitennummer (Standard: 1)
`limit`	integer	Datensätze pro Seite (max: 100)
`status`	string	active \| inactive \| error

Erfolgreiche Antwort

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

Laden starten

POST/stations/{id}/start

Parameter	Erforderlich	Beschreibung
`connector_id`	Ja	Anschluss-ID
`user_id`	Ja	Benutzer-ID

Transaktionen

GET/transactions

Parameter	Beispiel
`station_id`	station_123
`date_from`	2026-01-01
`date_to`	2026-04-18

Webhooks

Erhalten Sie Echtzeit-Benachrichtigungen zu wichtigen Ereignissen.

Unterstützte Ereignisse

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

Payload-Beispiel

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

Fehlercodes

Code	Beschreibung
`400`	Ungültige Anfrage – fehlerhafte Parameter
`401`	Nicht autorisiert – API-Schlüssel erforderlich
`403`	Verboten – unzureichende Berechtigungen
`404`	Nicht gefunden – Ressource existiert nicht
`429`	Zu viele Anfragen – Rate-Limit überschritten
`500`	Interner Serverfehler

Beispiel für Fehlerantwort

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