Dokumen Perubahan Versi
Terdapat perubahan yang memecah keserasian dalam API Lokasi EV. Titik akhir v1 semasa akan ditamatkan pada 31 Mac 2026. Pelanggan yang menggunakan v1 dinasihatkan untuk merancang migrasi mereka ke v2.Konsep teras API kekal tidak berubah; bagaimanapun, v2 memperkenalkan beberapa penyesuaian teknikal, seperti jenis data yang dikemas kini untuk beberapa parameter dan penghapusan medan yang tidak relevan atau tidak konsisten boleh dipercayai.Bahagian di bawah menerangkan perubahan dengan terperinci.AutentikasiTitik akhir autentikasi tidak berubah, dan titik akhir OAuth sedia ada kekal digunakan.Pengevangan APIHanya URL asas untuk keempat-empat hujung lokasi telah dikemas kini daripada v1 ke v2. Laluan hujung itu sendiri kekal tidak berubah.URL Asas Lama - https://api.shell.com/ev/v1/locationsURL Asas Baru - https://api.shell.com/ev/v2/locationsUbah butiran pada 3 hujung: /locations, /id, /nearby)Perubahan Jenis Data dalam Payload ResponsRespons kini merangkumi tiga medan UUID (UUID Lokasi, UUID EVSE, UUID Pengecas). Sebelumnya, nilai-nilai ini disediakan sebagai integer. Kini semuanya telah dikemas kini kepada jenis data rentetan untuk memastikan format dan konsistensi UUID yang betul.Di bawah adalah nama parameter tepat dalam muatan respons.Data.uidData.evses.uidData.evses.connectors.uuidParameter berikut telah dialih keluar dalam versi v2.Data.accessibility.remarkdata.operatorCommentData.evse.connectors.deletedData.evse.connectors.fixedCableData.evse.connectors.tarifData.evse.connectors.dikemas kiniData.evse.connectors.updatedByData.evse.deletedData.evse.physicalReferenceSila ambil perhatian bahawa komponen tarif disediakan di hujung /locations/id .Maklumat tarif hanya boleh diperoleh mengikut lokasi. Ubah butiran pada hujung /locations/markersTiga parameter telah dialih keluar daripada muatan respons dalam v2.Data.geoHashData.markerTypeData.uniquekeyButiran TarifButiran tarif hanya akan tersedia di titik akhir locations/id, yang bermaksud butiran tarif hanya boleh diperoleh bagi setiap lokasi dan bukan secara pukal. Perubahan ini disebabkan oleh ciri penetapan harga dinamik yang telah diaktifkan dalam produk kami. Selain itu, untuk mendapatkan maklumat tarif, ProviderID adalah wajib dalam parameter pertanyaan. ProviderId akan dikongsi oleh Shell. Di bawah adalah contoh komponen tarif untuk rujukan. "tariffs": [
{
"createdBy": "STAGE_TEST1",
"currency": "",
"elements": [
{
"priceComponents": [
{
"price": 1.7208002,
"stepSize": 1,
"type": "ENERGY",
"vat": 21
}
]
},
{
"priceComponents": [
{
"price": 4.1202,
"stepSize": 10,
"type": "TIME",
"vat": 8
}
]
},
{
"priceComponents": [
{
"price": 0.84033614,
"stepSize": 1,
"type": "FLAT",
"vat": 21
}
]
},
{
"priceComponents": [
{
"price": 0.84033614,
"stepSize": 1,
"type": "FLAT",
"vat": 21
}
]
}
]
{
"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"
}
]SokonganJika anda memerlukan bantuan atau mempunyai sebarang pertanyaan, sila hubungi pasukan teknikal kami dengan membuka tiket sokongan:
