Parking / Create

POST

api

assets

parking

Parking / Create

curl --request POST \
  --url https://api.chargecloud.dev/api/v1/assets/parking \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_uuid": "<string>",
  "physical_reference": "A-03",
  "max_vehicle_weight_kg": 1,
  "max_vehicle_height_cm": 1,
  "max_vehicle_length_cm": 1,
  "max_vehicle_width_cm": 1,
  "dangerous_goods_allowed": false,
  "drive_through": false,
  "restricted_to_type": false,
  "reservation_required": false,
  "time_limit_minutes": 123,
  "roofed": false,
  "lighting": false,
  "vehicle_type": [
    {
      "vehicle_type": "<string>"
    }
  ],
  "chargepoints": [
    {
      "chargepoints": "<string>"
    }
  ]
}
'

import requests

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

payload = {
    "location_uuid": "<string>",
    "physical_reference": "A-03",
    "max_vehicle_weight_kg": 1,
    "max_vehicle_height_cm": 1,
    "max_vehicle_length_cm": 1,
    "max_vehicle_width_cm": 1,
    "dangerous_goods_allowed": False,
    "drive_through": False,
    "restricted_to_type": False,
    "reservation_required": False,
    "time_limit_minutes": 123,
    "roofed": False,
    "lighting": False,
    "vehicle_type": [{ "vehicle_type": "<string>" }],
    "chargepoints": [{ "chargepoints": "<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>',
    physical_reference: 'A-03',
    max_vehicle_weight_kg: 1,
    max_vehicle_height_cm: 1,
    max_vehicle_length_cm: 1,
    max_vehicle_width_cm: 1,
    dangerous_goods_allowed: false,
    drive_through: false,
    restricted_to_type: false,
    reservation_required: false,
    time_limit_minutes: 123,
    roofed: false,
    lighting: false,
    vehicle_type: [{vehicle_type: '<string>'}],
    chargepoints: [{chargepoints: '<string>'}]
  })
};

fetch('https://api.chargecloud.dev/api/v1/assets/parking', 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/parking",
  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>',
    'physical_reference' => 'A-03',
    'max_vehicle_weight_kg' => 1,
    'max_vehicle_height_cm' => 1,
    'max_vehicle_length_cm' => 1,
    'max_vehicle_width_cm' => 1,
    'dangerous_goods_allowed' => false,
    'drive_through' => false,
    'restricted_to_type' => false,
    'reservation_required' => false,
    'time_limit_minutes' => 123,
    'roofed' => false,
    'lighting' => false,
    'vehicle_type' => [
        [
                'vehicle_type' => '<string>'
        ]
    ],
    'chargepoints' => [
        [
                'chargepoints' => '<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/parking"

	payload := strings.NewReader("{\n  \"location_uuid\": \"<string>\",\n  \"physical_reference\": \"A-03\",\n  \"max_vehicle_weight_kg\": 1,\n  \"max_vehicle_height_cm\": 1,\n  \"max_vehicle_length_cm\": 1,\n  \"max_vehicle_width_cm\": 1,\n  \"dangerous_goods_allowed\": false,\n  \"drive_through\": false,\n  \"restricted_to_type\": false,\n  \"reservation_required\": false,\n  \"time_limit_minutes\": 123,\n  \"roofed\": false,\n  \"lighting\": false,\n  \"vehicle_type\": [\n    {\n      \"vehicle_type\": \"<string>\"\n    }\n  ],\n  \"chargepoints\": [\n    {\n      \"chargepoints\": \"<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/parking")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"location_uuid\": \"<string>\",\n  \"physical_reference\": \"A-03\",\n  \"max_vehicle_weight_kg\": 1,\n  \"max_vehicle_height_cm\": 1,\n  \"max_vehicle_length_cm\": 1,\n  \"max_vehicle_width_cm\": 1,\n  \"dangerous_goods_allowed\": false,\n  \"drive_through\": false,\n  \"restricted_to_type\": false,\n  \"reservation_required\": false,\n  \"time_limit_minutes\": 123,\n  \"roofed\": false,\n  \"lighting\": false,\n  \"vehicle_type\": [\n    {\n      \"vehicle_type\": \"<string>\"\n    }\n  ],\n  \"chargepoints\": [\n    {\n      \"chargepoints\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"physical_reference\": \"A-03\",\n  \"max_vehicle_weight_kg\": 1,\n  \"max_vehicle_height_cm\": 1,\n  \"max_vehicle_length_cm\": 1,\n  \"max_vehicle_width_cm\": 1,\n  \"dangerous_goods_allowed\": false,\n  \"drive_through\": false,\n  \"restricted_to_type\": false,\n  \"reservation_required\": false,\n  \"time_limit_minutes\": 123,\n  \"roofed\": false,\n  \"lighting\": false,\n  \"vehicle_type\": [\n    {\n      \"vehicle_type\": \"<string>\"\n    }\n  ],\n  \"chargepoints\": [\n    {\n      \"chargepoints\": \"<string>\"\n    }\n  ]\n}"

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

{
  "parking": {
    "uuid": "<string>",
    "created_at": "2023-12-25",
    "modification_date": "2023-12-25",
    "location_uuid": "<string>",
    "physical_reference": "A-03",
    "max_vehicle_weight_kg": 1,
    "max_vehicle_height_cm": 1,
    "max_vehicle_length_cm": 1,
    "max_vehicle_width_cm": 1,
    "parking_direction": "PARALLEL",
    "dangerous_goods_allowed": false,
    "drive_through": false,
    "restricted_to_type": false,
    "reservation_required": false,
    "time_limit_minutes": 123,
    "roofed": false,
    "lighting": false,
    "vehicle_type": [
      {
        "vehicle_type": "<string>"
      }
    ],
    "chargepoints": [
      {
        "chargepoints": "<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:parkings

Headers

Accept-Language

string

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

Example:

"en"

Body

application/json

Creates a new parking spot at an existing location. Required permission: asset:parkings:create. Available contexts: API Key, User.

location_uuid

string

required

The UUID of the location this parking space belongs to. Parking spaces are always assigned to a location and are managed within that location's infrastructure.

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

physical_reference

string

required

Physical reference / signage label (e.g. bay number "A-12").

Maximum string length: 12

Example:

"A-03"

max_vehicle_weight_kg

integer<int32>

required

Maximum allowed vehicle weight in kilograms. Required for AFIR compliance and transmitted to the national access point (NAP).

Required range: x >= 0

max_vehicle_height_cm

integer<int32>

required

Maximum allowed vehicle height in centimetres. Particularly relevant for covered or underground parking. Required for AFIR compliance and transmitted to the national access point (NAP).

Required range: x >= 0

max_vehicle_length_cm

integer<int32>

required

Maximum allowed vehicle length in centimetres. Required for AFIR compliance and transmitted to the national access point (NAP).

Required range: x >= 0

max_vehicle_width_cm

integer<int32>

required

Maximum allowed vehicle width in centimetres. Required for AFIR compliance and transmitted to the national access point (NAP).

Required range: x >= 0

parking_direction

enum<string>

required

Orientation of the parking spot relative to the charging station, helping drivers position the vehicle correctly when pulling in to charge. Allowed values: PARALLEL (parallel to the station), PERPENDICULAR (at a right angle), ANGLE (angled).

Available options:

PARALLEL,

PERPENDICULAR,

ANGLE

dangerous_goods_allowed

boolean

default:false

Whether vehicles transporting dangerous goods (ADR) are allowed.

drive_through

boolean

default:false

Whether the bay is a drive-through position, where a vehicle can pull in, charge, and drive out without reversing. Must apply to all vehicle types assigned to this spot.

restricted_to_type

boolean

default:false

Whether the parking spot is restricted to the vehicle types listed in vehicle_type.

reservation_required

boolean

default:false

Whether drivers must reserve the bay before parking.

time_limit_minutes

integer<int32>

Maximum allowed parking duration in minutes. When set, drivers must vacate the spot after this limit, regardless of whether charging is still in progress.

roofed

boolean

default:false

Whether the parking spot is covered by a roof / canopy.

lighting

boolean

default:false

Whether the parking spot is illuminated at night.

vehicle_type

object[]

Vehicle types permitted on this parking spot. Combined with restricted_to_type to enforce the restriction. Required for AFIR compliance and used to filter parking spots by vehicle category in public outputs.

Show child attributes

chargepoints

object[]

UUIDs of the charging points associated with this parking spot. A spot may be linked to one or more charging points at the same location, and appears subordinated to the connector in the infrastructure overview.

Show child attributes

Response

The newly created parking spot.

parking

object

required

The parking spot record with its location, vehicle restrictions and charge points.

Show child attributes

⌘I

Parking / Create

curl --request POST \
  --url https://api.chargecloud.dev/api/v1/assets/parking \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_uuid": "<string>",
  "physical_reference": "A-03",
  "max_vehicle_weight_kg": 1,
  "max_vehicle_height_cm": 1,
  "max_vehicle_length_cm": 1,
  "max_vehicle_width_cm": 1,
  "dangerous_goods_allowed": false,
  "drive_through": false,
  "restricted_to_type": false,
  "reservation_required": false,
  "time_limit_minutes": 123,
  "roofed": false,
  "lighting": false,
  "vehicle_type": [
    {
      "vehicle_type": "<string>"
    }
  ],
  "chargepoints": [
    {
      "chargepoints": "<string>"
    }
  ]
}
'

import requests

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

payload = {
    "location_uuid": "<string>",
    "physical_reference": "A-03",
    "max_vehicle_weight_kg": 1,
    "max_vehicle_height_cm": 1,
    "max_vehicle_length_cm": 1,
    "max_vehicle_width_cm": 1,
    "dangerous_goods_allowed": False,
    "drive_through": False,
    "restricted_to_type": False,
    "reservation_required": False,
    "time_limit_minutes": 123,
    "roofed": False,
    "lighting": False,
    "vehicle_type": [{ "vehicle_type": "<string>" }],
    "chargepoints": [{ "chargepoints": "<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>',
    physical_reference: 'A-03',
    max_vehicle_weight_kg: 1,
    max_vehicle_height_cm: 1,
    max_vehicle_length_cm: 1,
    max_vehicle_width_cm: 1,
    dangerous_goods_allowed: false,
    drive_through: false,
    restricted_to_type: false,
    reservation_required: false,
    time_limit_minutes: 123,
    roofed: false,
    lighting: false,
    vehicle_type: [{vehicle_type: '<string>'}],
    chargepoints: [{chargepoints: '<string>'}]
  })
};

fetch('https://api.chargecloud.dev/api/v1/assets/parking', 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/parking",
  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>',
    'physical_reference' => 'A-03',
    'max_vehicle_weight_kg' => 1,
    'max_vehicle_height_cm' => 1,
    'max_vehicle_length_cm' => 1,
    'max_vehicle_width_cm' => 1,
    'dangerous_goods_allowed' => false,
    'drive_through' => false,
    'restricted_to_type' => false,
    'reservation_required' => false,
    'time_limit_minutes' => 123,
    'roofed' => false,
    'lighting' => false,
    'vehicle_type' => [
        [
                'vehicle_type' => '<string>'
        ]
    ],
    'chargepoints' => [
        [
                'chargepoints' => '<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/parking"

	payload := strings.NewReader("{\n  \"location_uuid\": \"<string>\",\n  \"physical_reference\": \"A-03\",\n  \"max_vehicle_weight_kg\": 1,\n  \"max_vehicle_height_cm\": 1,\n  \"max_vehicle_length_cm\": 1,\n  \"max_vehicle_width_cm\": 1,\n  \"dangerous_goods_allowed\": false,\n  \"drive_through\": false,\n  \"restricted_to_type\": false,\n  \"reservation_required\": false,\n  \"time_limit_minutes\": 123,\n  \"roofed\": false,\n  \"lighting\": false,\n  \"vehicle_type\": [\n    {\n      \"vehicle_type\": \"<string>\"\n    }\n  ],\n  \"chargepoints\": [\n    {\n      \"chargepoints\": \"<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/parking")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"location_uuid\": \"<string>\",\n  \"physical_reference\": \"A-03\",\n  \"max_vehicle_weight_kg\": 1,\n  \"max_vehicle_height_cm\": 1,\n  \"max_vehicle_length_cm\": 1,\n  \"max_vehicle_width_cm\": 1,\n  \"dangerous_goods_allowed\": false,\n  \"drive_through\": false,\n  \"restricted_to_type\": false,\n  \"reservation_required\": false,\n  \"time_limit_minutes\": 123,\n  \"roofed\": false,\n  \"lighting\": false,\n  \"vehicle_type\": [\n    {\n      \"vehicle_type\": \"<string>\"\n    }\n  ],\n  \"chargepoints\": [\n    {\n      \"chargepoints\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"physical_reference\": \"A-03\",\n  \"max_vehicle_weight_kg\": 1,\n  \"max_vehicle_height_cm\": 1,\n  \"max_vehicle_length_cm\": 1,\n  \"max_vehicle_width_cm\": 1,\n  \"dangerous_goods_allowed\": false,\n  \"drive_through\": false,\n  \"restricted_to_type\": false,\n  \"reservation_required\": false,\n  \"time_limit_minutes\": 123,\n  \"roofed\": false,\n  \"lighting\": false,\n  \"vehicle_type\": [\n    {\n      \"vehicle_type\": \"<string>\"\n    }\n  ],\n  \"chargepoints\": [\n    {\n      \"chargepoints\": \"<string>\"\n    }\n  ]\n}"

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

{
  "parking": {
    "uuid": "<string>",
    "created_at": "2023-12-25",
    "modification_date": "2023-12-25",
    "location_uuid": "<string>",
    "physical_reference": "A-03",
    "max_vehicle_weight_kg": 1,
    "max_vehicle_height_cm": 1,
    "max_vehicle_length_cm": 1,
    "max_vehicle_width_cm": 1,
    "parking_direction": "PARALLEL",
    "dangerous_goods_allowed": false,
    "drive_through": false,
    "restricted_to_type": false,
    "reservation_required": false,
    "time_limit_minutes": 123,
    "roofed": false,
    "lighting": false,
    "vehicle_type": [
      {
        "vehicle_type": "<string>"
      }
    ],
    "chargepoints": [
      {
        "chargepoints": "<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