Versionsänderungsdokument

Es gibt eine grundlegende Änderung in der EV Location API. Der aktuelle v1-Endpunkt wird am 31. März 2026 außer Betrieb genommen. Kunden, die v1 verwenden, wird empfohlen, ihre Migration auf v2 zu planen.

Die Kernkonzepte der API bleiben unverändert; v2 führt jedoch einige technische Anpassungen ein, wie z. B. aktualisierte Datentypen für bestimmte Parameter und die Entfernung nicht relevanter oder nicht durchgängig zuverlässiger Felder.

Die folgenden Abschnitte erläutern die Änderungen im Detail.

Authentifizierung

1. Der Authentifizierungsendpunkt bleibt unverändert, und der bestehende OAuth-Endpunkt wird weiterhin verwendet.

Versionierung der APIs

1. Nur die Basis-URL für alle vier Standort-Endpunkte wurde von v1 auf v2 aktualisiert. Die Endpunktpfade selbst bleiben unverändert.
   1. Alte Basis-URL - https://api.shell.com/ev/v1/locations
   2. Neue Basis-URL - https://api.shell.com/ev/v2/locations

Änderungen an 3 Endpunkten: /locations, /id, /nearby

1. Änderungen des Datentyps in der Nutzlast der Antwort
   1. Die Antwort enthält jetzt drei UUID-Felder (Location UUID, EVSE UUID, Connector UUID). Zuvor wurden diese Werte als Ganzzahlen angegeben. Sie wurden nun alle auf String-Datentypen aktualisiert, um eine ordnungsgemäße UUID-Formatierung und Konsistenz zu gewährleisten.
   2. Nachfolgend sind die genauen Parameternamen in der Nutzlast der Antwort aufgeführt.
      1. Data.uid
      2. Data.evses.uid
      3. Data.evses.connectors.uuid
2. Die folgenden Parameter wurden in Version v2 entfernt.
   1. Data.accessibility.remark
   2. data.operatorComment
   3. Data.evse.connectors.deleted
   4. Data.evse.connectors.fixedCable
   5. Data.evse.connectors.tariff
   6. Data.evse.connectors.updated
   7. Data.evse.connectors.updatedBy
   8. Data.evse.deleted
   9. Data.evse.physicalReference

Bitte beachten Sie, dass die Tarifkomponente im /locations/id Endpunkt zur Verfügung gestellt wird. Tarifinformationen können nur pro Standort abgerufen werden.

Details am /locations/markers Endpunkt ändern

1. Drei Parameter wurden in v2 aus der Antwort-Payload entfernt.
   1. Data.geoHash
   2. Data.markerType
   3. Data.uniquekey

Tarifdetails

Die Tarifdetails werden nur noch im Endpunkt locations/id verfügbar sein, was bedeutet, dass Tarifdetails nur noch pro Standort und nicht mehr massenhaft abgefragt werden können. Diese Änderung ist auf die Funktion der dynamischen Preisgestaltung zurückzuführen, die in unserem Produkt aktiviert wurde.

Außerdem ist die ProviderID im Abfrageparameter obligatorisch, um die Tarifinformationen abzurufen. Die ProviderId wird von Shell freigegeben.

Nachfolgend ein Beispiel für eine Tarifkomponente als Referenz.

"tariffs": [
    {
      "createdBy": "STAGE_TEST1",
      "currency": "",
      "elements": [
        {
          "priceComponents": [
            {
              "price": 1.7208002,
              "stepSize": 1,
              "type": "ENERGIE",
              "vat": 21
            }
          ]
        },
        {
          "priceComponents": [
            {
              "price": 4.1202,
              "stepSize": 10,
              "type": "TIME",
              "vat": 8
            }
          ]
        },
        {
          "priceComponents": [
            {
              "price": 0.84033614,
              "stepSize": 1,
              "type": "FLAT",
              "vat": 19
            }
          ]
        }
      ],
      "endDateTime": "2026-09-02T15:03:09Z",
      "internalId": "CH*FR*SHE*9ddc09f2-1a66-47e9-b6f3-40b0d55tt923",
      "lastUpdated": "2025-09-10T08:43:09Z",
      "maxPrice": 999,
      "minPrice": 0,
      "operatorId": "FR*SHE",
      "powerRange": {
        "max": 150,
        "min": 0
      },
      "providerId": "Shell_RP_2",
      "startDateTime": "2026-01-21T08:43:09Z",
      "tariffAltText": null,
      "tariffId": "9ddc09f2-1a66-47e9-b6f3-40b0d55tt923",
      "tariffType": "DRIVER"
    }                              
]

Support

1. Wenn Sie Hilfe benötigen oder Fragen haben, wenden Sie sich bitte an unser technisches Team, indem Sie ein Support-Ticket erstellen:

   Erstelle ein Ticket