HomeGuidesAPI ReferenceChangelog
Terms of Use
Terms of Use

Release Notes: Public API 2.119.0

4 months ago by Valentin Alexiev
  1. Add array of tags to the resource Charge Point in the response and as filter.
    1. Add tags array when creating a Charge Point, Charge Points / Create
    2. Filter a list of Charge points by a tag Charge Points / Listing
    3. Update tags of a Charge Point, Charge Points / Update
    4. Tags are included in the response of getting a Charge Point, Charge Points / Read

Release Notes: Public API 2.118.0

4 months ago by Svetoslav Mitov
  1. Remove Error 422 from Sessions / Read endpoint - The payload you provided is invalid.
    Not relevant to GET methods.
  2. Add new revenue sharing parameters to Resource / Partner Contracts
    • fixedFeePerSessionAc
      number or NULL
      Description: Additional flat fee that is applied for every billed session and subtracted from the Partner’s share of the revenue for each session on AC Charging Station. This fee is available only if the feature "Additional Platform Fees" is enabled for the system.
    • fixedFeePerSessionDc
      number or NULL
      Description: Additional flat fee that is applied for every billed session and subtracted from the Partner’s share of the revenue for each session on DC Charging Station. This fee is available only if the feature "Additional Platform Fees" is enabled for the system.
    • feePerKwhAc
      number or NULL
      Description:Additional flat fee that is applied for every billed kWh and subtracted from the Partner's share of the revenue for each kWh billed on AC Charging Station. This fee is available only if the feature "Additional Platform Fees" is enabled for the system.
    • feePerKwhDc
      number or NULL
      Description: Additional flat fee that is applied for every billed kWh and subtracted from the Partner's share of the revenue for each kWh billed on DC Charging Station. This fee is available only if the feature "Additional Platform Fees" is enabled for the system.
    • handlingFee
      number or NULL
      Description: Additional percentage fee to be applied on the total amount paid by the user for the session. This fee is then subtracted from the Partner's share of the revenue. This fee is available only if the feature "Additional Platform Fees" is enabled for the system.
  3. Replace Security Event Log endpoint names:
    • /public-api/resources/security-events-log/v2.0 changed to /public-api/resources/security-events/v2.0
    • /public-api/resources/security-events-log/v2.0/{securityEventLog} changed to /public-api/resources/security-events/v2.0/{securityEvent}
  4. Option to enforce users to reset password at next login
    • The functionality to enforce EV Driver users to follow the Password Reset process at next login has been introduced to AMPECO's backend. It is also introduced for the Public API:
      • resource / user [POST, PATCH]
        • requirePasswordReset - optional
          boolean
          Description: Sets a requirement for the user to set a new password when they next open the app. After a new password is set, this option resets automatically.

Release Notes: Public API 2.117.0

4 months ago by Svetoslav Mitov
  1. Introduce Locations v2.0 resource
    1. Properties:
      • id - readonly
        integer
      • name - required
        string
      • status - required
        enum
      • shortDescription - optional, translatable
        array or NULL
      • description - optional, translatable
        array or NULL
      • additionalDescription - optional, translatable
        array or NULL
      • locationImage - optional, readonly
      • images - optional, readonly
      • geoposition - required
        • latitude - required
          float
        • longitude - required
          float
      • address - required
        translatable
      • city - required
        string
      • region - optional
        string
      • state - optional, conditional depending on country = US or AU
        string or NULL
      • country - required
        string
      • postCode - required
        string
      • workingHours - required
        array
        • isAlwaysOpen - required
          boolean
        • alwaysOpenForUserGroupIds - optional
          array of group ids
          required if isAlwaysOpen = false; otherwise NULL
        • stopSessionsOutsideWorkingHours - optional
          boolean
          required if isAlwaysOpen = false
        • hours - optional
      • chargingZones - required, readonly
        array
      • timezone - optional (only when multi timezone is enabled)
        string
      • externalId - optional
        string
      • lastUpdatedAt - required
        timestamp
  2. Expose Charging Zones endpoint in the API
    Supported Methods: GET, POST, PATCH, DELETE
    • Properties:
      • id
        integer
      • name - required
        string
        Description: Internal name of the Charging Zone. This isn't visible to end-users in the app.
        locationId - required
        integer
        Description: The ID of the Location, which the Charging Zone belongs to.
      • status - required
        string
        Description: Enum: "active" "disabled"
      • appAdditionalInfo - optional
        object
        Description: Additional information for the charging zone that is shown in the mobile app when the Location is viewed.
      • title - required
        object
        Description: Locales that have been created and are not provided on an update will be deleted. Please provide values in all locales that you wish to keep.
      • description - required
        object
        Description: Locales that have been created and are not provided on an update will be deleted. Please provide values in all locales that you wish to keep.
    • Filter
      • locationId

Release Notes: Public API 2.116.0

5 months ago by Svetoslav Mitov
  1. Add field receiptId to Sessions / Listing resource [GET]
    1. receiptId
      string
      Description: ID of the receipt that is issued for the charging session.
  2. Utilities resource created and exposed via Public API
    The Utility resource will serve the purpose of categorising Charging Stations per "Utility Provider" entity, furthering the current split "per country" and "per state" for reporting purposes.
    1. resource / utilities
      Supported Methods: GET, POST, PUT, DELETE
      1. id
        integer, required
      2. name
        string, required
      3. createdAt
        string, date-time, required
        Description: ISO 8601 formatted date
  3. Expose Optimised Dynamic Pricing tariff in public API
    1. Properties:
      1. thresholdPriceForEnergy - number, decimal
      2. priceForEnergyWhenOptimized - number, decimal
      3. pricePerKwh - number, decimal
      4. minPrice - number, decimal
      5. connectionFee - number, decimal
      6. taxID - number
      7. preAuthorizeAmount - number, decimal
  4. Postal Code is optional for country Israel (IL)

Release Notes: Public API 2.115.0

5 months ago by Svetoslav Mitov
  1. Fix: Smart Charging property set to "Disabled" by default when new Charge Point is created using Charge Point v2.0
  2. Fix: contractId is populated when declared in POST and PATCH requests for Charge Point v2.0
  3. Added circuitId to the Charge Point smartCharging object
    1. circuitId
      integer, optional, readonly
      Description: The ID of the DLM Circuit to which the charge point is added (if any).
  4. Enabled filtering by circuitId in Charge Points endpoint
    1. *circuitId
      integer
      Description: Only list charge points added to a certain DLM Circuit

Release Notes: Public API 2.114.0

5 months ago by Svetoslav Mitov
  1. Expose Firmware Update in action / charge point
    • PATH PARAMETERS
      chargePoint (required)
      integer
    • BODY SCHEMA
      url (required)
      string
      Description: Location (URL) from which to retrieve the firmware. retrieveAfter
      datetime
      Description: Specifies the date and time after which the Charge Point should retrieve the new firmware. If not provided, the current _datetime_ will be used.
      retries
      integer [0..10]
      Description: Specifies how many times the Charge Point must try to retrieve the (new) firmware before giving up.
      interval
      integer [0..3600]
      Description: The interval in seconds between each retry.
      signed (required)
      boolean
      Description: Indicates a Signed Firmware Update.
      signingCertificate
      string
      Description: Required if "signed" is true.
      signature
      string
      Description: Required if "signed" is true.

Release Notes: Public API 2.113.0

6 months ago by Svetoslav Mitov
  1. Sending HardwareStatusNotification Occupied instead of Preparing
    • In order to comply with OCPP 2.0.1 implementations, Occupied status has been introduced (instead of Preparing status as per OCPP 1.6).

Release Notes: Public API 2.112.0

6 months ago by Svetoslav Mitov
  1. New query parameter includePartnerInvite in the Users listing endpoint
    • include
      array of strings
      Items Value: partnerInvites
      Description: When used the User object will include an array of strings for the partner invites that the User has accepted.
  2. Version 2.0 of resource / Charge Points officially published
  3. Adapt web hooks to be able to produce Kafka events
  4. Fix: Deleted Location resource does not allow creation of a new Location if externalId values match.
    • Due to soft-deletion process for location resources, validation does not allow for the externalId property value to be duplicated. This has been fixed.

Release Notes: Public API 2.111.0

6 months ago by Svetoslav Mitov
  1. Fix: Incorrect pagination for partner accounts in a single GET request
    • per_page parameter within resource / Partners / Listing endpoint failed to return the correct number of partner accounts when stated.
  2. Public API Documentation enhancement
    • Separate Authorisations resource from Sessions endpoint
    • Separate Template resource from the Charge Point endpoint
    • Remove Proposal resource

Release Notes: Public API 2.110.0

6 months ago by Svetoslav Mitov
  1. Session start response codes - implement enums
    Endpoints affected:
    • https://{{baseUrl}}/public-api/actions/charge-point/v1.0/{{chargePoint}}/start/{{evse}}
    • https://{{baseUrl}}/public-api/actions/evse/v1.0/{{evse}}/start