Set the charging mode of one of the connectors of a charging station
Description
Sets the charging mode of one of the connectors of a charging station. A Smappee charging station can have up to 2 connectors depending on the type of station.
When facing a charging station with two connectors (i.e. you are looking at the LED light) the right connector has position 1, the left has position 2. A charging station with one connector only has position 1.
Setting the mode to PAUSED will disable the connector for charging. Active sessions will be stopped, i.e. the connected vehicle will not charge anymore. The session will be terminated when the cable is disconnected.
Setting the mode to NORMAL also supports setting the charging speed of the connector. The speed can be specified as
a percentage of the max current setting of the connector. In that case only values in range 0..100 are accepted. Any other value will produce an HTTP 400 error
an absolute value in ampere. In that case only values in range 0..connector.maxCurrent are accepted. Any other value will produce an HTTP 400 error.
Setting the charging speed and SMART mode is only supported for AC charging stations. For DC charging stations (EV Base Ultra), only the NORMAL mode (without limit) and PAUSED mode are supported.
Resource URL
https://app1pub.smappee.net/dev/v3/chargingstations/[SERIALNUMBER]/connectors/[position]/mode
Parameters
Parameter | Type | Description |
---|---|---|
SERIALNUMBER | Path Parameter | The serialnumber of the Charging Station |
POSITION | Path Parameter |
|
HTTP method
PUT
HTTP header
Authorization: Bearer [ACCESS_TOKEN]
[ACCESS_TOKEN] being the access token received from the Get token or Refresh token authentication calls.
HTTP body
The body allows you to choose the charging mode. When “NORMAL“ is chosen, optionally a current limit can be set as percentage or ampere. The body should be sent in JSON format as per one of the examples below:
{
"mode": "NORMAL",
"limit": {
"unit": "PERCENTAGE",
"value": 75
}
}
{
"mode": "NORMAL",
"limit": {
"unit": "AMPERE",
"value": 10
}
}
{
"mode": "SMART"
}
Versioning
Version 1 (v1)
This call does not exist in this version
Version 2 (v2)
This call does not exist in this version
Version 3 (v3)
This call was introduced in this version