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 the charging station (i.e. you are looking at the LED light) the right connector has position 1, the other has position 2.

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.

Resource URL

https://app1pub.smappee.net/dev/v3/chargingstations/[SERIALNUMBER]/connectors/[position]/mode

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"
}

{
  "mode": "PAUSED"
}

Versioning

Version 1 (v1)

This call does not exist in this version

Version 2 (v2)