Übersicht der API-Referenz
GraphQL ist eine Abfragesprache für APIs. Sie ermöglicht es Ihnen, genau die Daten in einem einzigen Aufruf abzufragen, die Sie benötigen, anstatt viele feste REST-Endpoints zu durchlaufen.
Die API basiert auf GraphQL. Jede Ressource, etwa Fahrzeuge, Stationen, Routen und Navigationssitzungen, ist über eine einzige GraphQL API verfügbar. Sie können jede davon als Query, Mutation oder Subscription aufrufen.
Wenn Sie neu bei GraphQL sind, ist die offizielle GraphQL-Dokumentation ein guter Einstiegspunkt.
GraphQL-Endpoints
Queries, Mutationen und Subscriptions sind unter den folgenden Endpoints verfügbar. Ein Beispiel finden Sie unter Ihre erste Anfrage senden.
Für Queries und Mutationen verwenden Sie:
Für Subscriptions verwenden Sie:
Ressourcen
Durchsuchen Sie die API nach Ressourcen. Jeder der folgenden Abschnitte verweist auf die zugehörigen Queries, Mutationen und Subscriptions.
| Ressource | Beschreibung |
|---|---|
| Fahrzeug | Rufen Sie EV-Spezifikationen, Verbrauchsmodelle und Premium-Preisdaten ab. |
| Verbundenes Fahrzeug | Verbinden Sie ein Fahrzeug mit einem Konnektivitätsanbieter und rufen Sie dessen Live-Daten ab. |
| Station | Rufen Sie einzelne Ladestationen, Stationen in der Nähe und Ausstattungen ab. |
| Stationsbewertung | Lesen, hinzufügen und entfernen Sie Nutzerbewertungen für eine Ladestation. |
| Stationstarif | Rufen Sie die Ladekosten an einer Station ab. |
| Stationsbetreiber | Rufen Sie Details zum Ladepunktbetreiber einer Station ab. |
| Kacheln | Greifen Sie auf Stationsdaten als Vektor- oder JSON-Kartenkacheln zu, um sie auf einer Karte darzustellen. |
| Route | Berechnen Sie eine EV-Route mit Ladestopps, Energieverbrauch und Fahrzeit. |
| Lkw-Route | Berechnen Sie eine E-Lkw-Route unter Berücksichtigung von Fahrzeuggewicht und -abmessungen. |
| Navigation | Verfolgen Sie den Fortschritt eines Fahrzeugs entlang einer Route und erhalten Sie Echtzeit-Updates. |
| Emissionen | Berechnen Sie die Emissionen, die durch die Wahl einer Route eingespart werden. |
| Isoline | Visualisieren Sie das Gebiet, das ein Fahrzeug von einem Punkt aus mit seinem Ladezustand erreichen kann. |
Authentifizierung
Jede Anfrage wird mit den Headern x-client-id und x-app-id authentifiziert. Wie Sie diese erhalten und senden, erfahren Sie unter Autorisierung.
Pagination
Listen-Queries verwenden entweder die Argumente size und page oder, bei cursorbasierter Pagination, die Argumente first und after. Details finden Sie unter Pagination.
Rate Limiting
Für Anfragen gilt Rate Limiting.
Lebenszyklus
Chargetrip verwendet eine einzige, sich weiterentwickelnde GraphQL API anstelle versionierter Releases. Wie wir mit breaking und nicht-breaking Änderungen umgehen, erfahren Sie unter Lebenszyklus.
War dieser Inhalt hilfreich?