Standtypen

Business+

Standtypen (Reihen-, Eck-, Inselstand usw.) mit Standard- und erlaubten Größen verwalten. Verwenden Sie ID oder Schlüssel beim Anlegen von Ständen. Lesen braucht plans:read, Änderungen plans:write.

Erforderliche Bereiche: plans

Zugriffsstufe: GET plans:read POST / PUT / PATCH / DELETE plans:write Mehr zu Zugriffsstufen

Feature-Flag: booths

Endpunkte

GET


                    /api/v1/booth-types

Alle Standtypen auflisten (booth_count = Stände mit diesem Typ)

GET


                    /api/v1/booth-types/{id}

Einzelnen Standtyp abrufen

POST


                    /api/v1/booth-types

Standtyp anlegen. Pflicht ist nur booth_type_name; ohne Schlüssel wird er aus dem Namen erzeugt, Größen sind standardmäßig 3 x 3 m (erlaubt 1 bis 20 m)

PUT/PATCH


                    /api/v1/booth-types/{id}

Standtyp aktualisieren (nur die gesendeten Felder). Eine Schlüsseländerung aktualisiert auch die Dienstleistungen, die auf den alten Schlüssel beschränkt sind

DELETE


                    /api/v1/booth-types/{id}

Standtyp löschen. Abgelehnt mit 409, solange Stände ihn verwenden; deaktivieren Sie ihn stattdessen (is_active: false)

Abfrageparameter

Parameter	Beschreibung
`is_active`	Nur aktive (1) oder nur inaktive (0) Standtypen
`event_key`	Nur Standtypen, die für dieses Event angeboten werden (Typen ohne Event-Einschränkung sind enthalten)
`page`	Seitennummer (Standard: 1)
`per_page`	Ergebnisse pro Seite (Standard: 25, max. 100)

Request-Schema

Parameter	Typ	Erforderlich	Beschreibung
`booth_type_name`	string	Ja	Name für Admins und Aussteller (2–255 Zeichen)
`booth_type_key`	string	Nein	Eindeutiger Schlüssel (Kleinbuchstaben, Ziffern, "_" und "-"); ohne Angabe aus dem Namen erzeugt
`description`	string	Nein	Kurzbeschreibung (z. B. "eine offene Seite")
`default_width`	float	Nein	Standardbreite in Metern (Standard 3)
`default_depth`	float	Nein	Standardtiefe in Metern (Standard 3)
`min_width`	float	Nein	Erlaubter Bereich in Metern (min_width/max_width, min_depth/max_depth; Standard 1 bis 20)
`max_width`	float	Nein	Erlaubter Bereich in Metern (min_width/max_width, min_depth/max_depth; Standard 1 bis 20)
`min_depth`	float	Nein	Erlaubter Bereich in Metern (min_width/max_width, min_depth/max_depth; Standard 1 bis 20)
`max_depth`	float	Nein	Erlaubter Bereich in Metern (min_width/max_width, min_depth/max_depth; Standard 1 bis 20)
`color`	string	Nein	Farbe im Lageplan (Hex, z. B. #3B82F6)
`category_keys`	array	Nein	Nur für diese Ausstellerkategorien (leer = alle)
`event_keys`	array	Nein	Nur für diese Events (leer = alle)
`is_active`	boolean	Nein	Ob der Typ für neue Stände verwendet werden kann

Response-Schema

Feld	Typ
`id`	integer
`booth_type_key`	string
`booth_type_name`	string
`description`	string\|null
`default_width`	float
`default_depth`	float
`min_width`	float
`max_width`	float
`min_depth`	float
`max_depth`	float
`color`	string
`category_keys`	array
`event_keys`	array
`is_active`	boolean
`sort_order`	integer
`booth_count`	integer
`created_at`	string
`updated_at`	string

Codebeispiele

curl -X GET "https://ihr-mandant.plandocket.com/api/v1/booth-types" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

<?php
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://ihr-mandant.plandocket.com';

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $baseUrl . '/api/v1/booth-types',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

const apiKey = 'YOUR_API_KEY';
const baseUrl = 'https://ihr-mandant.plandocket.com';

const response = await fetch(`${baseUrl}/api/v1/booth-types`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
  },
});

const data = await response.json();
console.log(data);

import requests

api_key = 'YOUR_API_KEY'
base_url = 'https://ihr-mandant.plandocket.com'

headers = {
    'Authorization': f'Bearer {api_key}',
}

response = requests.get(f'{base_url}/api/v1/booth-types', headers=headers)
data = response.json()
print(data)

Beispiel-Antwort

200 OK

{
    "data": [
        {
            "id": 1,
            "booth_type_key": "string",
            "booth_type_name": "string",
            "description": "string",
            "default_width": 100,
            "default_depth": 100,
            "min_width": 100,
            "max_width": 100,
            "min_depth": 100,
            "max_depth": 100,
            "color": "string",
            "category_keys": [],
            "event_keys": [],
            "is_active": true,
            "sort_order": 1,
            "booth_count": 1,
            "created_at": "2026-01-15T10:00:00+01:00",
            "updated_at": "2026-01-15T10:00:00+01:00"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 25,
        "total": 1,
        "total_pages": 1
    }
}

Stand-Reservierungen Check-Ins