HomeGuidesAPI ReferenceChangelog
Terms of Use
Changelog
Terms of Use

Release Notes: Public API 2.125.0

about 1 year ago by Valentin Alexiev
  1. Add externalAppData in the payload of the following notifications, Notifications / Subscribe:
    1. SessionStartStopNotification
    2. SessionUpdateNotification
  2. Add externalAppData in the response and as a filter of:
    1. Sessions / Listing
    2. Sessions / Read

Release Notes: Public API 2.124.0

about 1 year ago by Valentin Alexiev
  1. Add subsidyIntegrationId (the subsidy integration id that should be applied for a tariff, only valid for Energy ToU tariffs.) to:
    1. the payload of TariffChangedNotification notification, Notifications / Subscribe
    2. pricing object of tariffs:
      1. Tariffs / Listing
      2. Tariffs / Create
      3. Tariffs / Read
      4. Tariffs / Update
      5. Tariff Snapshot / Read
  2. Add response 404 - "The record is not found" to:
    1. Charge Points / Delete
    2. Locations / Delete

Release Notes: Public API 2.123.0

about 1 year ago by Valentin Alexiev
  1. Add durationFeeFrom and durationFeeTo to:
    1. the payload of TariffChangedNotification notification, Notifications / Subscribe
    2. pricing object of tariffs:
      1. Tariffs / Listing
      2. Tariffs / Create
      3. Tariffs / Read
      4. Tariffs / Update
      5. Tariff Snapshot / Read

Release Notes: Public API 2.122.0

about 1 year ago by Valentin Alexiev
  1. Add more measurands to the payload of SessionMeterValuesNotification webhook, Notifications / Subscribe
    1. Current.Import
    2. Current.Offered
    3. Energy.Active.Import.Register
    4. Power.Offered
    5. Temperature
    6. Voltage
  2. Change the endpoint of Charge Point Models to
    /public-api/resources/charge-point-models/v1.0/
  3. Change the endpoint of Charge Point Vendors to
    /public-api/resources/charge-point-vendors/v1.0
  4. Add evsePhysicalReference property to filter object of Charge Points / Listing to get EVSE by physical reference (e.g. from QR code). Remove physicalReference property.

Release Notes: Public API 2.121.0

about 1 year ago by Valentin Alexiev
  1. Notifications:
    1. Create a new webhook when CDR Received, Notifications / Subscribe
    2. Add user id and email to the payload of the partnerInvite.changed notification, Notifications / Subscribe
    3. Add meterStart and meterStop to the payload of the SessionStartStopNotification notification, Notifications / Subscribe
  2. Circuits:
    1. Add support for electricity meters to circuits, Circuits / Create
    2. Add user priorities for using a circuit, Circuits / User Priorities / Create
  3. Add possibility to start a session without EVSE ID, Actions / Start Charging Session Without EVSE
  4. Rename applyToUsersOfChargePointOwner to applyToUsersOfChargePointPartner in restrictions of a tariff, Tariffs / Create
  5. Add EVSE status to the roaming object, Charge Point / EVSEs / Listing

Release Notes: Public API 2.120.0

about 1 year ago by Valentin Alexiev
  1. Implement pagination support for sessions history, Sessions / Listing
    • page
      integer
      The page number to fetch (defaults to 1). Not used in cursor pagination.
    • per_page
      integer
      The numbers of items to return. Used in both page and cursor pagination to declare the page size.

Release Notes: Public API of AMPECO Charge 3.50.0

about 1 year ago by Valentin Alexiev
  1. Deprecate setSessionLimitToZeroOnIdle in the resource Circuit.

Release Notes: Public API 2.119.0

about 1 year 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

about 1 year ago by Svetoslav Mitov
  1. Remove Error 422 from Sessions / Read endpoint -The payload you provided is invalid.
    Not relevant toGET methods.
  2. Add new revenue sharing parameters toResource / 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. ReplaceSecurity 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

about 1 year ago by Svetoslav Mitov
  1. IntroduceLocations 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. ExposeCharging 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