Documentation API

Authentification

Toutes les requêtes API nécessitent une authentification par clé API. Obtenez votre clé dans les paramètres du compte.

Ne partagez jamais votre clé API. Utilisez OAuth 2.0 pour les applications publiques.

Exemple cURL

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

Exemple JavaScript / Fetch

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

Endpoints de l'API

URL de base

https://api.ureticy.com/v1

Types de contenu

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

Limitation du débit

Les requêtes API sont limitées à 100 par minute. Au-delà, vous recevrez une erreur HTTP 429.

Gérer les bornes

Lister les bornes

GET/stations

Paramètre	Type	Description
`page`	integer	Numéro de page (par défaut : 1)
`limit`	integer	Enregistrements par page (max : 100)
`status`	string	active \| inactive \| error

Réponse de succès

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

Démarrer la charge

POST/stations/{id}/start

Paramètre	Obligatoire	Description
`connector_id`	Oui	ID du connecteur
`user_id`	Oui	ID utilisateur

Transactions

GET/transactions

Paramètre	Exemple
`station_id`	station_123
`date_from`	2026-01-01
`date_to`	2026-04-18

Webhooks

Recevez des notifications en temps réel sur les événements importants.

Événements pris en charge

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

Exemple de 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 } }

Codes d'erreur

Code	Description
`400`	Requête incorrecte — paramètres invalides
`401`	Non autorisé — clé API requise
`403`	Interdit — autorisations insuffisantes
`404`	Introuvable — la ressource n'existe pas
`429`	Trop de requêtes — limite de débit dépassée
`500`	Erreur interne du serveur

Exemple de réponse d'erreur

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