Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

Returns detailed information of charging sessions of a charging station:

Resource URL

https://app1pub.smappee.net/dev/v3/chargingstations/[SERIALNUMBER]/sessions

HTTP method

GET

HTTP header

Authorization: Bearer [ACCESS_TOKEN]

(info) [ACCESS_TOKEN] being the access token received from the Get token or Refresh token authentication calls.

Parameters

Parameter

Type

Description

SERIALNUMBER

Path Parameter

The serial number of the charging station

active

Query parameter

A flag that indicates if only active sessions should be returned. A session is active if the vehicle linked to the station is still charging (actually still connected). The default value for this parameter is "false" returning only completed sessions.

range

Query parameter

Required parameter.

A comma separated list of EPOCH milliseconds. Example ?range=1635721200000,1637190000000 → will return sessions that started between Nov 1st 2021 and Nov 18th 2021 (timezone Europe/Brussels). The end of the range is exclusive, i.e. sessions that started exactly at midnight of Nov 18th 2021 or thereafter, are NOT returned.

Note that it is allowed to only specify the start of the range. Example ?range=1635721200000 → will return sessions that started on or after Nov 1st 2021 (timezone Europe/Brussels).

Example

https://app1pub.smappee.net/dev/v3/charginstationschargingstations/6000999999/sessions?range=1635721200000,1637190000000

Result

Code Block
languagepy
{
  "id": 123,
  "serialNumber": 5820999999,
  "authenticationType": "RFID",
  "rfid": "The rfid that started the session",
  "csmsTransactionId": "The id of the transaction created by the CSMS system linked to the charging station or empty if there is no such system",
  "from": 1635721200000,
  "to": 1637190000000,
  "status": "INITIAL || STARTED || CHARGING || SUSPENDED || STOPPING || STOPPED",
  "range": 100,
  "duration": 2,
  "priority": 100,
  "startReading": 100.96,
  "stopReading": 115.21
}

Versioning

Version 1 (v1)

Not supported

Version 2 (v2)

Not supported

Version 3 (v3)

Introduced.

Page Properties
hiddentrue
idrest-api-method


Index

2

Resource URL

https://app1pub.smappee.net/dev/v3/servicelocation/123/meteringconfiguration

HTTP method

GET

Description

Returns detailed information of a specific service location:

  • General information

  • Appliances

  • Actuators (Smappee Switch / Comfort plug)

  • Sensors (Gas & Water monitor)

  • channelsConfiguration (Smappee Plus/Pro)

  • Metering configuration (Smappee Genius & Connect-serie)



Panel
titleContent
Table of Contents