Controllers / Create

POST

api

assets

controllers

curl --request POST \
  --url https://api.chargecloud.dev/api/v1/assets/controllers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_uuid": "<string>",
  "logging": true,
  "fairmode": false,
  "software": "abb",
  "name": "<string>",
  "charge_point_model": "<string>",
  "ssl": false,
  "ip_address": "<string>",
  "dns_name": "<string>",
  "ip_port": 123,
  "proxy_port": 123,
  "manufacturer": "<string>",
  "mobile_number": "<string>",
  "icc_id": "<string>",
  "imsi": "<string>",
  "imei": "<string>",
  "sim_card_name": "<string>",
  "radius_pwd": "<string>",
  "pin": "<string>",
  "puk": "<string>",
  "alternative_heartbeat_interval": 3630,
  "alternative_meter_values_interval": 3630,
  "alternative_ftp_host": "<string>",
  "serial_number": "<string>",
  "article_number": "<string>",
  "u_ids": [
    {
      "u_id": "<string>"
    }
  ]
}
'

import requests

url = "https://api.chargecloud.dev/api/v1/assets/controllers"

payload = {
    "location_uuid": "<string>",
    "logging": True,
    "fairmode": False,
    "software": "abb",
    "name": "<string>",
    "charge_point_model": "<string>",
    "ssl": False,
    "ip_address": "<string>",
    "dns_name": "<string>",
    "ip_port": 123,
    "proxy_port": 123,
    "manufacturer": "<string>",
    "mobile_number": "<string>",
    "icc_id": "<string>",
    "imsi": "<string>",
    "imei": "<string>",
    "sim_card_name": "<string>",
    "radius_pwd": "<string>",
    "pin": "<string>",
    "puk": "<string>",
    "alternative_heartbeat_interval": 3630,
    "alternative_meter_values_interval": 3630,
    "alternative_ftp_host": "<string>",
    "serial_number": "<string>",
    "article_number": "<string>",
    "u_ids": [{ "u_id": "<string>" }]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    location_uuid: '<string>',
    logging: true,
    fairmode: false,
    software: 'abb',
    name: '<string>',
    charge_point_model: '<string>',
    ssl: false,
    ip_address: '<string>',
    dns_name: '<string>',
    ip_port: 123,
    proxy_port: 123,
    manufacturer: '<string>',
    mobile_number: '<string>',
    icc_id: '<string>',
    imsi: '<string>',
    imei: '<string>',
    sim_card_name: '<string>',
    radius_pwd: '<string>',
    pin: '<string>',
    puk: '<string>',
    alternative_heartbeat_interval: 3630,
    alternative_meter_values_interval: 3630,
    alternative_ftp_host: '<string>',
    serial_number: '<string>',
    article_number: '<string>',
    u_ids: [{u_id: '<string>'}]
  })
};

fetch('https://api.chargecloud.dev/api/v1/assets/controllers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.chargecloud.dev/api/v1/assets/controllers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'location_uuid' => '<string>',
    'logging' => true,
    'fairmode' => false,
    'software' => 'abb',
    'name' => '<string>',
    'charge_point_model' => '<string>',
    'ssl' => false,
    'ip_address' => '<string>',
    'dns_name' => '<string>',
    'ip_port' => 123,
    'proxy_port' => 123,
    'manufacturer' => '<string>',
    'mobile_number' => '<string>',
    'icc_id' => '<string>',
    'imsi' => '<string>',
    'imei' => '<string>',
    'sim_card_name' => '<string>',
    'radius_pwd' => '<string>',
    'pin' => '<string>',
    'puk' => '<string>',
    'alternative_heartbeat_interval' => 3630,
    'alternative_meter_values_interval' => 3630,
    'alternative_ftp_host' => '<string>',
    'serial_number' => '<string>',
    'article_number' => '<string>',
    'u_ids' => [
        [
                'u_id' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.chargecloud.dev/api/v1/assets/controllers"

	payload := strings.NewReader("{\n  \"location_uuid\": \"<string>\",\n  \"logging\": true,\n  \"fairmode\": false,\n  \"software\": \"abb\",\n  \"name\": \"<string>\",\n  \"charge_point_model\": \"<string>\",\n  \"ssl\": false,\n  \"ip_address\": \"<string>\",\n  \"dns_name\": \"<string>\",\n  \"ip_port\": 123,\n  \"proxy_port\": 123,\n  \"manufacturer\": \"<string>\",\n  \"mobile_number\": \"<string>\",\n  \"icc_id\": \"<string>\",\n  \"imsi\": \"<string>\",\n  \"imei\": \"<string>\",\n  \"sim_card_name\": \"<string>\",\n  \"radius_pwd\": \"<string>\",\n  \"pin\": \"<string>\",\n  \"puk\": \"<string>\",\n  \"alternative_heartbeat_interval\": 3630,\n  \"alternative_meter_values_interval\": 3630,\n  \"alternative_ftp_host\": \"<string>\",\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"u_ids\": [\n    {\n      \"u_id\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.chargecloud.dev/api/v1/assets/controllers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"location_uuid\": \"<string>\",\n  \"logging\": true,\n  \"fairmode\": false,\n  \"software\": \"abb\",\n  \"name\": \"<string>\",\n  \"charge_point_model\": \"<string>\",\n  \"ssl\": false,\n  \"ip_address\": \"<string>\",\n  \"dns_name\": \"<string>\",\n  \"ip_port\": 123,\n  \"proxy_port\": 123,\n  \"manufacturer\": \"<string>\",\n  \"mobile_number\": \"<string>\",\n  \"icc_id\": \"<string>\",\n  \"imsi\": \"<string>\",\n  \"imei\": \"<string>\",\n  \"sim_card_name\": \"<string>\",\n  \"radius_pwd\": \"<string>\",\n  \"pin\": \"<string>\",\n  \"puk\": \"<string>\",\n  \"alternative_heartbeat_interval\": 3630,\n  \"alternative_meter_values_interval\": 3630,\n  \"alternative_ftp_host\": \"<string>\",\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"u_ids\": [\n    {\n      \"u_id\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chargecloud.dev/api/v1/assets/controllers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"location_uuid\": \"<string>\",\n  \"logging\": true,\n  \"fairmode\": false,\n  \"software\": \"abb\",\n  \"name\": \"<string>\",\n  \"charge_point_model\": \"<string>\",\n  \"ssl\": false,\n  \"ip_address\": \"<string>\",\n  \"dns_name\": \"<string>\",\n  \"ip_port\": 123,\n  \"proxy_port\": 123,\n  \"manufacturer\": \"<string>\",\n  \"mobile_number\": \"<string>\",\n  \"icc_id\": \"<string>\",\n  \"imsi\": \"<string>\",\n  \"imei\": \"<string>\",\n  \"sim_card_name\": \"<string>\",\n  \"radius_pwd\": \"<string>\",\n  \"pin\": \"<string>\",\n  \"puk\": \"<string>\",\n  \"alternative_heartbeat_interval\": 3630,\n  \"alternative_meter_values_interval\": 3630,\n  \"alternative_ftp_host\": \"<string>\",\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"u_ids\": [\n    {\n      \"u_id\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "controller": {
    "uuid": "<string>",
    "created_at": "2023-12-25",
    "updated_at": "2023-12-25",
    "status": "Available",
    "location_uuid": "<string>",
    "logging": true,
    "fairmode": false,
    "software": "abb",
    "name": "<string>",
    "backend_communication_type": "ocpp_1_5",
    "mobile_communication_type": "DSL",
    "modification_date": "2023-12-25",
    "firmware_version": "<string>",
    "charge_point_model": "<string>",
    "ssl": false,
    "ip_address": "<string>",
    "dns_name": "<string>",
    "ip_port": 123,
    "proxy_port": 123,
    "manufacturer": "<string>",
    "mobile_number": "<string>",
    "icc_id": "<string>",
    "imsi": "<string>",
    "imei": "<string>",
    "sim_card_name": "<string>",
    "radius_pwd": "<string>",
    "pin": "<string>",
    "puk": "<string>",
    "alternative_heartbeat_interval": 3630,
    "alternative_meter_values_interval": 3630,
    "alternative_ftp_host": "<string>",
    "serial_number": "<string>",
    "article_number": "<string>",
    "u_ids": [
      {
        "u_id": "<string>"
      }
    ]
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "errors": [
    {
      "errorKey": "<string>",
      "message": "<string>",
      "parameter": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

Authorizations

Authorization

string

header

required

OAuth2 Bearer Authorization

Scopes

asset:controllers

Headers

Accept-Language

string

BCP 47 language tag for content negotiation (e.g. en, de-DE).

Example:

"en"

Body

application/json

Creates a controller (the hardware unit that drives one or more charging points) and registers it at a location. Required permission: asset:controllers:create. Available contexts: API Key, User.

location_uuid

string

required

The UUID of the location this controller is assigned to. A controller must always be linked to exactly one location and cannot be reassigned after creation.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$

logging

boolean

default:true

required

Records detailed protocol logs when true. Defaults to true.

fairmode

boolean

default:false

required

When true, caps output to share available power across active sessions.

software

enum<string>

required

Firmware/software stack the controller runs, selected per manufacturer. Must be compatible with backend_communication_type and is required for firmware update management. Allowed values are lowercase manufacturer or model identifiers (e.g. abb, alfen, keba, mennekes_ecu, siemens_sicharge_d); each names the vendor firmware family the backend talks to.

Available options:

mennekes,

mennekes_ecu,

mennekes_amtron_non_eichrecht,

mennekes_amedio_eichrecht,

mennekes_amedio_non_eichrecht,

mennekes_4you_500,

mennekes_4business_700,

mennekes_4business_700_eichrecht,

nidec,

ebg,

phoenix,

ecotap,

abb,

abb_terra_ac,

alfen,

amperfied,

ampure,

hubject,

kathrein,

keba,

kostad_sissy2,

heliox,

innogy,

ochp,

ebee,

enercharge,

chargeamps,

schneiderelectric,

tritium,

walther,

vinci_proxy,

vestel,

volkswagen,

chargehere,

schrack,

ebemobility,

kostad,

circontrol,

eluminocity,

abl,

abl_em4,

bauer_gen3,

bauer_gen4,

gewiss,

getpower,

delta,

photon,

porsche,

powerjames,

ads_tec,

siemens,

siemens_sicharge_d,

smight,

aixacct,

alpitronic,

stoehr,

meenergy,

whbcharging,

starchargeaurora,

compleo_solo,

evboxdc,

evboxliviqo,

unknown,

smappee,

hager_witty_share,

hager_witty_park,

hager_witty_pro,

zaptec,

peblar,

rzb,

kempower,

spelsberg,

mahlechargebig,

goe

Example:

"abb"

name

string

required

Display name. Must be unique across the client's controllers and exactly match the chargeBoxIdentity configured on the physical device. Avoid mixed case, umlauts, special characters and spaces; use underscores instead.

Maximum string length: 50

backend_communication_type

enum<string>

required

Protocol the controller uses to talk to the ChargeCloud backend. Must match the configuration on the physical device and be supported by the chosen software. Allowed values: ocpp_1_5 (OCPP-1.5 SOAP), ocpp_1_6_soap (OCPP-1.6 SOAP), ocpp_1_6_json (OCPP-1.6 JSON Websocket), ocpp_1_6_json_v2 (OCPP-1.6 JSON, V2), ocpp_201_json (OCPP-2.0.1 JSON).

Available options:

ocpp_1_5,

ocpp_1_6_soap,

ocpp_1_6_json,

ocpp_1_6_json_v2,

ocpp_201_json

mobile_communication_type

enum<string>

required

Network type used to reach the backend. Allowed values: DSL (wired), GSM (cellular via SIM), WLAN.

Available options:

DSL,

GSM,

WLAN

charge_point_model

string

Charging point hardware model. Found on the purchase receipt, in the station documentation, or via the serial number in the boot notification.

Maximum string length: 20

ssl

boolean

default:false

When true, the backend connection uses TLS. Required for all backend communication types except OCPP 1.6 JSON V2.

ip_address

string

IP address of the controller. Optional. When you supply an icc_id, the API derives the IP from the matching SIM card and ignores any value sent in this field. The IP+port combination is rejected if it collides with another controller that does not allow shared IPs.

dns_name

string

Hostname of the controller, alternative to ip_address. Only allowed for backend communication types that support hostname addressing.

ip_port

integer<int64>

TCP port of the controller. Only allowed for backend communication types that support direct port addressing.

proxy_port

integer<int64>

TCP port of the backend proxy. Only allowed for backend communication types that use a proxy.

manufacturer

string

Hardware manufacturer reported by the device.

mobile_number

string

Phone number of the SIM card.

Maximum string length: 25

icc_id

string

ICCID of the installed SIM card. When provided, the IP address is taken from the matching SIM card record.

Maximum string length: 25

imsi

string

IMSI of the installed SIM card.

Maximum string length: 30

imei

string

IMEI of the cellular modem.

Maximum string length: 30

sim_card_name

string

Free-text SIM card label.

Maximum string length: 50

radius_pwd

string

RADIUS password for network authentication, where applicable.

Maximum string length: 50

string

PIN code of the SIM card.

Maximum string length: 5

puk

string

PUK code of the SIM card. Unlocks the SIM after wrong PIN attempts.

Maximum string length: 8

alternative_heartbeat_interval

integer<int64>

Overrides the default heartbeat interval (seconds). Range: 60-7200; recommended 900. Not applicable for OCPP 1.6 JSON controllers.

Required range: 60 <= x <= 7200

alternative_meter_values_interval

integer<int64>

Overrides the default meter values reporting interval (seconds). Range: 60-7200.

Required range: 60 <= x <= 7200

alternative_ftp_host

string

Overrides the default FTP host for diagnostic logs and firmware artefacts.

Maximum string length: 55

serial_number

string

Hardware serial number from the manufacturer.

Maximum string length: 16

article_number

string

Manufacturer SKU identifying the model.

Maximum string length: 16

u_ids

object[]

Authentication uIds (RFID/NFC tag IDs) accepted for local authorization. Empty when none are configured.

Show child attributes

Response

The newly created controller in full projection.

controller

object

required

The controller record with its backend connectivity, SIM card and interval settings.

Show child attributes

⌘I

Controllers / Create

curl --request POST \
  --url https://api.chargecloud.dev/api/v1/assets/controllers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_uuid": "<string>",
  "logging": true,
  "fairmode": false,
  "software": "abb",
  "name": "<string>",
  "charge_point_model": "<string>",
  "ssl": false,
  "ip_address": "<string>",
  "dns_name": "<string>",
  "ip_port": 123,
  "proxy_port": 123,
  "manufacturer": "<string>",
  "mobile_number": "<string>",
  "icc_id": "<string>",
  "imsi": "<string>",
  "imei": "<string>",
  "sim_card_name": "<string>",
  "radius_pwd": "<string>",
  "pin": "<string>",
  "puk": "<string>",
  "alternative_heartbeat_interval": 3630,
  "alternative_meter_values_interval": 3630,
  "alternative_ftp_host": "<string>",
  "serial_number": "<string>",
  "article_number": "<string>",
  "u_ids": [
    {
      "u_id": "<string>"
    }
  ]
}
'

import requests

url = "https://api.chargecloud.dev/api/v1/assets/controllers"

payload = {
    "location_uuid": "<string>",
    "logging": True,
    "fairmode": False,
    "software": "abb",
    "name": "<string>",
    "charge_point_model": "<string>",
    "ssl": False,
    "ip_address": "<string>",
    "dns_name": "<string>",
    "ip_port": 123,
    "proxy_port": 123,
    "manufacturer": "<string>",
    "mobile_number": "<string>",
    "icc_id": "<string>",
    "imsi": "<string>",
    "imei": "<string>",
    "sim_card_name": "<string>",
    "radius_pwd": "<string>",
    "pin": "<string>",
    "puk": "<string>",
    "alternative_heartbeat_interval": 3630,
    "alternative_meter_values_interval": 3630,
    "alternative_ftp_host": "<string>",
    "serial_number": "<string>",
    "article_number": "<string>",
    "u_ids": [{ "u_id": "<string>" }]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    location_uuid: '<string>',
    logging: true,
    fairmode: false,
    software: 'abb',
    name: '<string>',
    charge_point_model: '<string>',
    ssl: false,
    ip_address: '<string>',
    dns_name: '<string>',
    ip_port: 123,
    proxy_port: 123,
    manufacturer: '<string>',
    mobile_number: '<string>',
    icc_id: '<string>',
    imsi: '<string>',
    imei: '<string>',
    sim_card_name: '<string>',
    radius_pwd: '<string>',
    pin: '<string>',
    puk: '<string>',
    alternative_heartbeat_interval: 3630,
    alternative_meter_values_interval: 3630,
    alternative_ftp_host: '<string>',
    serial_number: '<string>',
    article_number: '<string>',
    u_ids: [{u_id: '<string>'}]
  })
};

fetch('https://api.chargecloud.dev/api/v1/assets/controllers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.chargecloud.dev/api/v1/assets/controllers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'location_uuid' => '<string>',
    'logging' => true,
    'fairmode' => false,
    'software' => 'abb',
    'name' => '<string>',
    'charge_point_model' => '<string>',
    'ssl' => false,
    'ip_address' => '<string>',
    'dns_name' => '<string>',
    'ip_port' => 123,
    'proxy_port' => 123,
    'manufacturer' => '<string>',
    'mobile_number' => '<string>',
    'icc_id' => '<string>',
    'imsi' => '<string>',
    'imei' => '<string>',
    'sim_card_name' => '<string>',
    'radius_pwd' => '<string>',
    'pin' => '<string>',
    'puk' => '<string>',
    'alternative_heartbeat_interval' => 3630,
    'alternative_meter_values_interval' => 3630,
    'alternative_ftp_host' => '<string>',
    'serial_number' => '<string>',
    'article_number' => '<string>',
    'u_ids' => [
        [
                'u_id' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.chargecloud.dev/api/v1/assets/controllers"

	payload := strings.NewReader("{\n  \"location_uuid\": \"<string>\",\n  \"logging\": true,\n  \"fairmode\": false,\n  \"software\": \"abb\",\n  \"name\": \"<string>\",\n  \"charge_point_model\": \"<string>\",\n  \"ssl\": false,\n  \"ip_address\": \"<string>\",\n  \"dns_name\": \"<string>\",\n  \"ip_port\": 123,\n  \"proxy_port\": 123,\n  \"manufacturer\": \"<string>\",\n  \"mobile_number\": \"<string>\",\n  \"icc_id\": \"<string>\",\n  \"imsi\": \"<string>\",\n  \"imei\": \"<string>\",\n  \"sim_card_name\": \"<string>\",\n  \"radius_pwd\": \"<string>\",\n  \"pin\": \"<string>\",\n  \"puk\": \"<string>\",\n  \"alternative_heartbeat_interval\": 3630,\n  \"alternative_meter_values_interval\": 3630,\n  \"alternative_ftp_host\": \"<string>\",\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"u_ids\": [\n    {\n      \"u_id\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.chargecloud.dev/api/v1/assets/controllers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"location_uuid\": \"<string>\",\n  \"logging\": true,\n  \"fairmode\": false,\n  \"software\": \"abb\",\n  \"name\": \"<string>\",\n  \"charge_point_model\": \"<string>\",\n  \"ssl\": false,\n  \"ip_address\": \"<string>\",\n  \"dns_name\": \"<string>\",\n  \"ip_port\": 123,\n  \"proxy_port\": 123,\n  \"manufacturer\": \"<string>\",\n  \"mobile_number\": \"<string>\",\n  \"icc_id\": \"<string>\",\n  \"imsi\": \"<string>\",\n  \"imei\": \"<string>\",\n  \"sim_card_name\": \"<string>\",\n  \"radius_pwd\": \"<string>\",\n  \"pin\": \"<string>\",\n  \"puk\": \"<string>\",\n  \"alternative_heartbeat_interval\": 3630,\n  \"alternative_meter_values_interval\": 3630,\n  \"alternative_ftp_host\": \"<string>\",\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"u_ids\": [\n    {\n      \"u_id\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chargecloud.dev/api/v1/assets/controllers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"location_uuid\": \"<string>\",\n  \"logging\": true,\n  \"fairmode\": false,\n  \"software\": \"abb\",\n  \"name\": \"<string>\",\n  \"charge_point_model\": \"<string>\",\n  \"ssl\": false,\n  \"ip_address\": \"<string>\",\n  \"dns_name\": \"<string>\",\n  \"ip_port\": 123,\n  \"proxy_port\": 123,\n  \"manufacturer\": \"<string>\",\n  \"mobile_number\": \"<string>\",\n  \"icc_id\": \"<string>\",\n  \"imsi\": \"<string>\",\n  \"imei\": \"<string>\",\n  \"sim_card_name\": \"<string>\",\n  \"radius_pwd\": \"<string>\",\n  \"pin\": \"<string>\",\n  \"puk\": \"<string>\",\n  \"alternative_heartbeat_interval\": 3630,\n  \"alternative_meter_values_interval\": 3630,\n  \"alternative_ftp_host\": \"<string>\",\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"u_ids\": [\n    {\n      \"u_id\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "controller": {
    "uuid": "<string>",
    "created_at": "2023-12-25",
    "updated_at": "2023-12-25",
    "status": "Available",
    "location_uuid": "<string>",
    "logging": true,
    "fairmode": false,
    "software": "abb",
    "name": "<string>",
    "backend_communication_type": "ocpp_1_5",
    "mobile_communication_type": "DSL",
    "modification_date": "2023-12-25",
    "firmware_version": "<string>",
    "charge_point_model": "<string>",
    "ssl": false,
    "ip_address": "<string>",
    "dns_name": "<string>",
    "ip_port": 123,
    "proxy_port": 123,
    "manufacturer": "<string>",
    "mobile_number": "<string>",
    "icc_id": "<string>",
    "imsi": "<string>",
    "imei": "<string>",
    "sim_card_name": "<string>",
    "radius_pwd": "<string>",
    "pin": "<string>",
    "puk": "<string>",
    "alternative_heartbeat_interval": 3630,
    "alternative_meter_values_interval": 3630,
    "alternative_ftp_host": "<string>",
    "serial_number": "<string>",
    "article_number": "<string>",
    "u_ids": [
      {
        "u_id": "<string>"
      }
    ]
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "errors": [
    {
      "errorKey": "<string>",
      "message": "<string>",
      "parameter": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

Getting started - Core

Core API

Authorizations

Scopes

Headers

Body

Response