HomeGuidesAPI ReferenceChangelog
Terms of Use
Changelog
Terms of Use
Back to All

3.183.0 release notes

about 9 hours ago by ReadMe API
  1. ⚠️ Breaking changes
    1. Removed UNKNOWN from the accepted values for evseCriteria.connectorType on POST /public-api/resources/booking-requests/v1.0. Requests sending UNKNOWN will now fail validation.
    2. Removed UNKNOWN from the accepted values for parkingType and items in facilities on the Location create and update endpoints (POST /public-api/resources/locations/v2.0, PUT /public-api/resources/locations/v2.0/{location}). Requests sending UNKNOWN will now fail validation.
  2. ✨ New features
    1. Added POST /public-api/actions/users/v1.0/{user}/subscribe-to-plan to subscribe a user to a subscription plan. The request body accepts the required planId and reason, and an optional paymentMethodId that must reference an approved payment method belonging to the user.
    2. Added GET /public-api/resources/user-devices/v1.0 and GET /public-api/resources/user-devices/v1.0/USERDEVICE to list and retrieve registered user devices. The list endpoint supports filtering by userId, deviceIdentifier, operatorId, and hasUser, plus sorting by id, createdAt, and updatedAt.
    3. Added the optional capabilityOverrides property to the EVSE request body and response on the v2.0 nested EVSE endpoints (/public-api/resources/charge-points/v2.0/{chargePoint}/evses and /public-api/resources/charge-points/v2.0/{chargePoint}/evses/{evse}) and on the v2.1 EVSE endpoints (/public-api/resources/evses/v2.1 and /public-api/resources/evses/v2.1/{evse}). It allows overriding individual EVSE capabilities such as rfidReader, creditCardPayable, contactlessCardSupport, debitCardPayable, chipCardSupport, pedTerminal, remoteStartStop, unlockCapable, reservable, chargingProfileCapable, chargingPreferencesCapable, startSessionConnectorRequired, and tokenGroupCapable.
    4. Added the optional pricing.incrementalPreAuthorizationAmount and restrictions.adHocIncrementalPreAuthorizationAmount properties to the Tariff request body and response on POST /public-api/resources/tariffs/v1.0, PUT /public-api/resources/tariffs/v1.0/{tariff}, PATCH /public-api/resources/tariffs/v1.0/{tariff}, GET /public-api/resources/tariffs/v1.0, and GET /public-api/resources/tariffs/v1.0/{tariff}.
    5. Added the read-only incrementalPreAuthorizationSupported boolean to Tariff responses on GET /public-api/resources/tariffs/v1.0 and GET /public-api/resources/tariffs/v1.0/{tariff}, indicating whether the operator's configuration supports incremental pre-authorizations. This field is ignored if sent in a PATCH request body.
    6. Added the optional preAuthorizedAmount and the required incrementalPreAuthorizationEnabled properties to Session responses on GET /public-api/resources/sessions/v1.0 and GET /public-api/resources/sessions/v1.0/{session}.
    7. Added the optional pricing.incrementalPreAuthorizationAmount and restrictions.adHocIncrementalPreAuthorizationAmount properties to the Tariff Snapshot response on GET /public-api/resources/tariff-snapshots/v1.0/{tariffSnapshot}.
  3. 🔧 Improvements
    1. Location responses on GET /public-api/resources/locations/v2.0 and GET /public-api/resources/locations/v2.0/{location} now omit parkingType and filter out individual facilities items whose stored value is UNKNOWN, instead of returning the placeholder value.
    2. Location image responses now omit category when its stored value is unknown, instead of returning the placeholder value.
    3. The error message property is now guaranteed to be present in 429 Too Many Requests responses on POST /public-api/actions/charge-point/v1.0/{chargePoint}/start/{evse} and POST /public-api/actions/evse/v1.0/{evse}/start.