User Get Recent Stations

Request

"user-get-recent-stations" identifies the call as a user-get-recent-stations call.

Fields

user

This field identifies the customer (object).

identifier-type

How to identify the user (string).

The identifier-type can be one of:

  • "evco-id"
  • "rfid"
  • "username"
identifier
The identifier is something that uniquely identifies the customer, depending on the identifier-type (string).
token (optional)

A token can be used to authenticate the user (string).

For example: if the identifier type is username and the identifier is the user’s username, then token is used for authentication instead of a password.

limit
Limit the response to this number of stations (integer).

Response

Fields

stations

An array of stations (array of objects).

id

The responser’s ID of the station (integer).

Use this ID to get more details. See also Station Get By IDs.

name
The name of the station, human readable (string).
latitude
Latitude of this station (float).
longitude
Longitude of this station (float).
dynamic-status-summary

Whether the station has available connectors (string).

Can be one of:

  • "Available"
  • "Occupied"
  • "Offline"
  • null
owner-type

The type of the company (string or null).

E.g. “hotel”.

HTTP Status codes

200 OK
The request was processed successfully.

Result codes

0
Success
140
Authentication failed: No positive authentication response
144
Authentication failed: Email does not exist
145
Authentication failed: User token not valid

Examples

Request:

{
    "user-get-recent-stations": {
        "user": {
            "identifier-type": "username",
            "identifier": "youridentifier",
            "token": "87d4e3085af04671834ebeb127df33bf"
        },
        "limit": 2
    }
}

Response:

{
    "user": {
        "stations": [
            [
                {
                    "id": 1247,
                    "name": "Vattenfall Ladestation",
                    "latitude": 52.52119,
                    "longitude": 13.32143,
                    "dynamic-status-summary": "Available",
                    "owner-type": null
                },
                {
                    "id": 1248,
                    "name": "Hotel Station",
                    "latitude": 52.82119,
                    "longitude": 12.12143,
                    "dynamic-status-summary": "Occupied",
                    "owner-type": "hotel"
                }
            ]
        ]
    },
    "result": {
        "code": 0,
        "message": "Success."
    }
}