Documentazione API

Autenticazione

Tutte le richieste API richiedono l'autenticazione con una chiave API. Ottieni la tua chiave dalle impostazioni dell'account.

Non condividere mai la tua chiave API. Usa OAuth 2.0 per le applicazioni pubbliche.

Esempio cURL

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

Esempio JavaScript / Fetch

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

Endpoint API

URL di base

https://api.ureticy.com/v1

Tipi di contenuto

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

Limitazione delle richieste

Le richieste API sono limitate a 100 al minuto. In caso di superamento riceverai HTTP 429.

Gestisci stazioni

Elenco stazioni

GET/stations

Parametro	Tipo	Descrizione
`page`	integer	Numero di pagina (predefinito: 1)
`limit`	integer	Record per pagina (max: 100)
`status`	string	active \| inactive \| error

Risposta di successo

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

Avvia ricarica

POST/stations/{id}/start

Parametro	Obbligatorio	Descrizione
`connector_id`	Sì	ID connettore
`user_id`	Sì	ID utente

Transazioni

GET/transactions

Parametro	Esempio
`station_id`	station_123
`date_from`	2026-01-01
`date_to`	2026-04-18

Webhooks

Ricevi notifiche in tempo reale sugli eventi importanti.

Eventi supportati

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

Esempio di 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 } }

Codici di errore

Codice	Descrizione
`400`	Richiesta non valida — parametri non validi
`401`	Non autorizzato — chiave API obbligatoria
`403`	Accesso negato — autorizzazioni insufficienti
`404`	Non trovato — la risorsa non esiste
`429`	Troppe richieste — limite di frequenza superato
`500`	Errore interno del server

Esempio di risposta di errore

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