Skip to main content

First steps

Once you have the API key generated and you have properly authenticated yourself against the API, you can start using the endpoints. The following flow is a great starting point if you are a new to eMabler.

Creating your first site & adding a charger​

Creating a site​

First we suggest you create a new site to the system. At least a single site is required to start adding chargers to the platform. You can create your first site by calling the endpoint

POST /v2/sites

Give a parameter on the POST body for the name of the site:

{
  "name": "New Site Name"
}

You get the newly created site ID as a reply on the response body. You can then use this id to update or delete site information if needed.

Creating a charger​

After the site has been created, then you need to create a new charger.

POST /v2/chargers

Give a parameter on the POST body for the chargerId and name of the charger:

{
  "name": "New charger",
  "chargerId": "new-charger-id"
}

chargerId is used to match the physical charger to this one when the charger is connected to eMabler via OCPP. Please make sure that the chargerId matches the one you have set on the charger's configurations when setting it up.

caution

Charger ID needs to be globally unique. So we suggest you use some prefix on ID:s like <companyName>_actualID. For example we would create charger with ID: EMABLER_Charger12345

As a reply you get the freshly created charger as a 200 OK reply.

Connecting a charger​

Now you have a charger created on the system. The only thing left is to actually configure the charger to connect to the system.

info

Our TEST endpoint for chargers is:
wss://ocpp.emabler.net/ocpp/

If you specify this url as the OCPP endpoint on your charger and use the same chargerID that you just specified you get the unit connected to the platform.

Checking the status​

You can use the API to check the status of the charger connection.

GET /v2/chargers/:chargerId

Provide the same chargerId on the request that you used before. You will then receive the information from the charger as the response.

note

If the charger has not yet connected to the system, most of the charger provided information is empty (sockets, manufacturer, firmware version etc.). It might take a few minutes for the charger to send all the info about itself.

The most interesting fields when checking charger connection are:

You are done!

You have everything needed set up and you are ready to start your journey with eMabler platform! We appreciate any findings or suggestions to the API you might have and please don't hesitate to contact our support if needed.

Thank you for choosing eMabler!