Document privind modificările de versiune

Există o modificare majoră în API-ul EV Location. Punctul de acces actual v1 va fi scos din uz la data de 31 martie 2026. Clienților care utilizează v1 li se recomandă să își planifice migrarea la v2.

Conceptele de bază ale API-ului rămân neschimbate; cu toate acestea, v2 introduce câteva ajustări tehnice, cum ar fi tipurile de date actualizate pentru anumiți parametri și eliminarea câmpurilor irelevante sau care nu sunt fiabile în mod constant.

Secțiunile de mai jos explică modificările în detaliu.

Autentificare

Punctul final de autentificare rămâne neschimbat, iar punctul final OAuth existent continuă să fie utilizat.

Versiunile API-urilor

Doar URL-ul de bază pentru toate cele patru puncte finale de localizare a fost actualizat de la v1 la v2. Căile punctelor finale rămân neschimbate.
1. URL de bază vechi - https://api.shell.com/ev/v1/locations
2. URL de bază nou - https://api.shell.com/ev/v2/locations

Detalii privind modificările la 3 puncte finale: /locations, /id, /nearby

Modificări ale tipului de date în conținutul răspunsului
1. Răspunsul include acum trei câmpuri UUID (UUID locație, UUID EVSE, UUID conector). Anterior, aceste valori erau furnizate ca numere întregi. Acum au fost toate actualizate la tipuri de date de tip șir de caractere pentru a asigura formatarea corectă a UUID-urilor și consecvența.
2. Mai jos sunt prezentate denumirile exacte ale parametrilor din conținutul răspunsului.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
Următorii parametri au fost eliminați în versiunea v2.
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

Vă rugăm să rețineți că componenta tarifară este disponibilă la punctul final /locations/id . Informațiile privind tarifele pot fi preluate numai pentru fiecare locație.

Detalii privind modificările la punctul de acces /locations/markers

Trei parametri au fost eliminați din încărcătura răspunsului în v2.
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

Detalii privind tarifele

Detaliile privind tarifele vor fi disponibile numai la punctul de interfață locations/id, ceea ce înseamnă că acestea pot fi preluate numai pentru fiecare locație în parte și nu în bloc. Această modificare se datorează funcției de stabilire dinamică a prețurilor care a fost activată în produsul nostru.

De asemenea, pentru a prelua informațiile privind tarifele, ProviderID este obligatoriu în parametrul de interogare. ProviderID va fi furnizat de Shell.

Mai jos este prezentat un exemplu de componentă de tarif, pentru referință.

"tariffs": [
    {
 "createdBy": "STAGE_TEST1",
 "currency": "",
      "elements": [
 {
 "priceComponents": [
 {
 "price": 1.7208002,
 "stepSize": 1,
              "type": "ENERGY",
 "vat": 21
 }
 ]
 },
 {
 "priceComponents": [
 {
              "preț": 4,1202,
 "interval": 10,
 "tip": "TIME",
 "TVA": 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"
    } 
]

Asistență

Dacă aveți nevoie de asistență sau aveți întrebări, vă rugăm să contactați echipa noastră tehnică prin deschiderea unui tichet de asistență:

Creați un tichet

Selectați limba dvs.

EV Public Locations 2.1.2