Panoramica di API Reference
GraphQL è un linguaggio di query per le API. Ti permette di richiedere esattamente i dati di cui hai bisogno in una singola chiamata, invece di passare attraverso numerosi endpoint REST fissi.
L’API è basata su GraphQL. Ogni risorsa, come veicoli, stazioni, percorsi e sessioni di navigazione, è disponibile tramite un’unica API GraphQL. Puoi accedere a ciascuna come query, mutation o subscription.
Se non conosci GraphQL, la documentazione ufficiale di GraphQL è un buon punto di partenza.
Endpoint GraphQL
Query, mutation e subscription sono disponibili agli endpoint indicati di seguito. Consulta invia la tua prima richiesta per un esempio.
Per query e mutation, usa:
Per le subscription, usa:
Risorse
Esplora l’API per risorsa. Ogni sezione qui sotto rimanda alle relative query, mutation e subscription.
| Risorsa | Descrizione |
|---|---|
| Veicolo | Consulta le specifiche degli EV, i modelli di consumo e i dati sui prezzi premium. |
| Veicolo connesso | Collega un veicolo a un provider di connettività e recupera i suoi dati in tempo reale. |
| Stazione | Consulta le singole stazioni di ricarica, le stazioni nelle vicinanze e i servizi. |
| Valutazione stazione | Leggi, aggiungi e rimuovi le recensioni degli utenti per una stazione di ricarica. |
| Tariffa stazione | Consulta il costo della ricarica presso una stazione. |
| Gestore stazione | Consulta i dettagli sull’operatore dei punti di ricarica di una stazione. |
| Tile | Accedi ai dati delle stazioni come tile vettoriali o JSON per visualizzarli su una mappa. |
| Percorso | Calcola un percorso per EV con tappe di ricarica, consumo energetico e tempo di guida. |
| Percorso camion | Calcola un percorso per camion elettrici tenendo conto di peso e dimensioni del veicolo. |
| Navigazione | Monitora l’avanzamento di un veicolo lungo un percorso e ricevi aggiornamenti in tempo reale. |
| Emissioni | Calcola le emissioni risparmiate percorrendo un percorso. |
| Isolina | Visualizza l’area che un veicolo può raggiungere da un punto in base al suo stato di carica. |
Autenticazione
Ogni richiesta viene autenticata con gli header x-client-id e x-app-id. Consulta autorizzazione per scoprire come ottenerli e inviarli.
Paginazione
Le query di elenco usano gli argomenti size e page oppure, per la paginazione basata su cursore, gli argomenti first e after. Consulta paginazione per i dettagli.
Limitazione della frequenza
Le richieste sono soggette a limitazione della frequenza.
Ciclo di vita
Chargetrip utilizza un’unica API GraphQL in continua evoluzione anziché rilasci con versioni. Consulta ciclo di vita per scoprire come gestiamo le modifiche incompatibili e compatibili.
Questo contenuto ti è stato utile?