List Of Webhook Events
Types of Events
This is a list of all the types of events we currently send. We may add more at any time, so in developing and maintaining your code, you should not assume that only these types exist.
eDRV follows the best industry practices and you will notice that these events follow a pattern: resource.event
. Our goal is to design a consistent system that makes things easier to anticipate and code against.
There are four types of Webhooks sent by eDRV:
-
Network Events Events triggered by activity on the network.
E.g. a chargestation going offline
Format:resource.event
-
Actions Events that report the states of a command sent to the chargestation.
E.g. a chargestation change configuration request
Format:action_name.status
-
Synchronous Events Events in response to adding / editing data on eDRV.
E.g. adding a connector on eDRV
Format:resource.event
-
Charging Intelligence Events Events triggered by eDRV's charging intelligence.
E.g. when a session's target energy value has been reached
Format:resource.event
Network Events
These are Asynchronous events triggered by network activity, for e.g. when a driver plugs in a cable.
Chargestation Webhooks
chargestation.online data
is a Chargestation
Whenever a charge station connects to eDRV
chargestation.offline data
is a Chargestation
Whenever a charge station loses connection to eDRV
chargestation.connector_status.updated data
is a Chargestation
Live reports of connector state directly from the chargestation.
Session Webhooks
session.updated data
is a Session
Occurs whenever a session field is updated. E.g. when the chargestation reports a new energy readings via the session.metrics
or the session.energy_report
field.
session.started data
is a Session
Occurs whenever the chargestation sends a charging start event and confirms that an energy transaction has begun.
session.ended data
is a Session
Occurs whenever the chargestation confirms that an energy transaction has stopped.
session.cancelled data
is a Session
Occurs whenever a session was cancelled. E.g. due to a failure to plug in the cable within time.
session.start_failure data
is a Session
Occurs when the chargestation was unable to start the session.
session.stop_failure data
is a Session
Occurs when the chargestation was unable to stop the session.
Webhooks for Actions
The format is Action.Status.
Status can be in one of three states:
requested
: The request has been sent to the chargestation
accepted
: The chargestation accepted the request. Please see the response object for any data returned
rejected
: The chargestation rejected the request. See response data for any error details reported by the chargestation
session.set_power_limit.requested / accepted / rejected data
is an Action
Occurs when reporting a set_power_limit action on a session.
session.clear_power_limit.requested / accepted / rejected data
is an Action
Occurs when reporting a clear_power_limit action on a session.
connector.set_power_limit.requested / accepted / rejected data
is an Action
Occurs when reporting a set_power_limit action on a connector.
connector.clear_power_limit.requested / accepted / rejected data
is an Action
Occurs when reporting a clear_power_limit action on a connector.
chargestation.set_power_limit.requested / accepted / rejected data
is an Action
Occurs when reporting a set_power_limit action on a chargestation or connector.
chargestation.clear_power_limit.requested / accepted / rejected data
is an Action
Occurs when reporting a clear_power_limit action on a chargestation or connector.
chargestation.get_configuration.requested / accepted / rejected data
is an Action
Occurs when fetching chargestation configurations via an API call.
Note: Please use GET /chargestations/{id}/configurations
request to see the full response.
chargestation.update_configuration.requested / accepted / rejected data
is an Action
Occurs when updating a chargestation configuration via an API call.
chargestation.trigger_message.requested / accepted / rejected data
is an Action
Occurs when a trigger_message action is sent via an API call.
chargestation.get_local_list_version.requested / accepted / rejecteddata
is an Action
Occurs when fetching the get_local_list_version via an API call.
chargestation.send_local_list.requested / accepted / rejected data
is an Action
Occurs when a send_local_list action is sent via an API call.
chargestation.get_composite_schedule.requested / accepted / rejected data
is an Action
Occurs when fetching get_composite_schedule via an API call.
chargestation.set_charging_profile.requested / accepted / rejected data
is an Action
Occurs when a set_charging_profile action is sent via an API call.
chargestation.clear_charging_profile.requested / accepted / rejected data
is an Action
Occurs when a clear_charging_profile action is sent via an API call.
Synchronous Events
Events that are triggered by Developer or User actions via the API or Dashboard.
organization.updated data
is an Organization
Occurs whenever an organization's data is updated.
location.created data
is a Location
Occurs whenever a new location is created.
location.updated data
is a Location
Occurs whenever a location is updated. E.g. when business hours are changed.
location.deleted data
is a Location
Occurs whenever a location is deleted.
chargestation.created data
is a Chargestation
Occurs whenever a new chargestation is created.
chargestation.updated data
is a Chargestation
The following fields trigger a chargestation update:
chargestation.endpoint
: An update to the Websocket connection URL
chargestation.active
: A change usually via an API call or the dashboard
chargestation.public
: A change usually via an API call or the dashboard
chargestation.open_for_business
: A change usually via an API call or the dashboard
chargestation.meta_data
: Any changes to the meta_data field
chargestation.deleted data
is a Chargestation
Occurs whenever a chargestation is deleted.
chargestation.connector.created data
is a Chargestation
Occurs whenever a connector is created.
chargestation.connector.updated data
is a Chargestation
All field changes will trigger a connector update. (Excluding status)
chargestation.connector.deleted data
is a Chargestation
Occurs whenever a connector is deleted.
user.created data
is a User
Occurs whenever a new user is created.
user.updated data
is a User
All field changes will trigger a user update.
user.deleted data
is a User
Whenever a user is deleted.
rate.created data
is a Rate
Occurs whenever a new rate is created.
rate.updated data
is a Rate
All field changes will trigger an update.
rate.deleted data
is a Rate
Whenever a rate is deleted.
rate_schedule.created data
is a Advance Rate
Occurs whenever a new rate schedule is created.
rate_schedule.updated data
is a Advance Rate
All field changes will trigger an update.
rate_schedule.deleted data
is a Advance Rate
Whenever a rate schedule is deleted.
rfid.created data
is a RFID
Occurs whenever a new rfid is created.
rfid.updated data
is a RFID
All field changes will trigger an update.
rfid.deleted data
is a RFID
Whenever a rfid is deleted.
session.created data
is a Session
Occurs whenever a new session has been created. eDRV is yet to receive a charging start event from the chargestation.
load_management.group.created data
is a Load Management
Occurs when a load management group is created.
load_management.group.updated data
is a Load Management
Occurs when a load management group is updated.
load_management.group.deleted data
is a Load Management
Occurs when a load management group is updated.
load_management.group.chargestation.added data
is a Load Management
Occurs when charge station is added to the load management group
load_management.group.chargestation.removed data
is a Load Management
Occurs when charge station is removed from the load management group
Charging Intelligence Events
Events that are triggered by eDRV charging intelligence. See Charging Intelligence
session.ev_charged data
is a Session
Occurs when eDRV detects that an EV is fully charged.
session.target.cost.reached data
is a Session
Occurs when eDRV detects that a session reached the target cost value.
session.target.time.reached data
is a Session
Occurs when eDRV detects that a session reached the target time value.
session.target.power.reached data
is a Session
Occurs when eDRV detects that a session reached the target energy value.
session.target.soc.reached data
is a Session
Occurs when eDRV detects that a session reached the target state of charge value.
Updated 3 months ago