(v.2.2.0) Introducing Temporary EVSE status and full Locations CRUD

🔹 What's New?

With version 2.2.0, we have just released 2 major upgrades to the Spirii API:

Temporary EVSE Status

Spirii's Temporary EVSE status functionality allows the charge point operator (CPO) to modify the charger status shared with the e-Mobility Service Providers (eMSPs). This feature updates the displayed charger status in the eMSP apps without touching the actual charger status.

The CPO can utilize this functionality for multiple use cases:

Maintenance mode: Avoid having drivers turn up at the charger only to be disappointed, whilst keeping the charger available for the technician to work on it.
Commissioning: Create hype for new chargers being planned, installed, tested, and configured.
Parking sensors: Allow an external sensor system to update the status when the parking space in front of the charger becomes occupied.
Reservation system: Allow an external booking system to update the reservation status of the charger.

📌 New Endpoints:
POSt /v2/temporary-evse-statuses
GET /v2/temporary-evse-statuses
GET /v2/temporary-evse-statuses/{id}
PATCH /v2/temporary-evse-statuses/{id}
DELETE /v2/temporary-evse-statuses/{id}

Locations V2 - Full CRUD operations

In addition to the existing GET endpoints, Locations V2 now includes the full CRUD operations, including the ability to create, update, and delete locations programmatically.

📌 New Endpoints:
POST /v2/locations
PATCH /v2/locations/{id}
DELETE /v2/locations/{id}

❌ What's Deprecated?

The old Locations V1 update endpoint is now deprecated under the Spirii Legacy API.

📌 Deprecated Endpoints:
PUT /locations

🔔 Action Required:
Partners using this endpoint should migrate to V2 as soon as possible.

🔄 Key Changes & Improvements

Endpoints	Change	Description
`POSt /v2/temporary-evse-statuses` `GET /v2/temporary-evse-statuses` `GET /v2/temporary-evse-statuses/{id}` `PATCH /v2/temporary-evse-statuses/{id}` `DELETE /v2/temporary-evse-statuses/{id}`	Temporary EVSE status	Set a temporary status on an EVSE Get existing temporary statuses for an EVSE Get all existing temporary statuses Update the temporary status for an EVSE Delete the temporary status for an EVSE
`POST /v2/locations` `PATCH /v2/locations/{id}` `DELETE /v2/locations/{id}`	Locations	Create a location Update an existing location Delete an existing location

📢 Migration & Next Steps

All partners using V1 should transition to V2 as soon as possible.
The V1 endpoint will remain operational for now, but will be fully sunset at a later date (to be announced).
If you use V1, please update your integrations accordingly and reach out if you need support.

📌 Breaking Changes Notice:
Some properties are not available in the V2 anymore and the structure has changes in a breaking manner, but if you are using V1, we strongly recommend migrating now to take advantage of the new capabilities and ensure long-term compatibility. See the API documentation for the full details.