Hebebühnen

Verwalten Sie Ihre Hebebühnen und Arbeitsbuchten: erstellen, positionieren, Buchungen zuweisen und Status verfolgen.

Die Hebebühnen-API erfordert ein aktives Hebebühnen-Modul (14,90€/Monat). Ohne aktives Modul geben alle Endpunkte 403 zurück.

Auf dieser Seite

GET /v1/hebebuehnen POST /v1/hebebuehnen PATCH /v1/hebebuehnen/:id DELETE /v1/hebebuehnen/:id POST /v1/hebebuehnen/:id/zuweisen POST /v1/hebebuehnen/:id/abweisen PATCH /v1/hebebuehnen/:id/status POST /v1/hebebuehnen/:id/abschliessen GET /v1/hebebuehnen/buchungen PATCH /v1/hebebuehnen/raum

Hebebühnen-Typen

two_post Zweisäulen-Hebebühne

four_post Viersäulen-Hebebühne

scissor Scherenbühne

pit Grube

GET/v1/hebebuehnen

Listet alle Hebebühnen Ihrer Werkstatt inkl. Raumdimensionen und aktiver Zuweisungen auf.

"token-method">curl "token-keyword">-X GET "token-url">https://api.schraubertermin.de/v1/hebebuehnen \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey'

Response200 OK

{
  "lifts": [
    {
      "id": "l1a2b3...",
      "name": "Bühne 1",
      "type": "two_post",
      "position_x": 100,
      "position_y": 50,
      "width_cm": 280,
      "length_cm": 500,
      "max_weight_kg": 3500,
      "ev_compatible": false,
      "is_available": true,
      "aktive_zuweisung": null
    }
  ],
  "floor": {
    "floor_width_cm": 1200,
    "floor_length_cm": 800
  }
}

POST/v1/hebebuehnen

Erstellt eine neue Hebebühne.

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Ja	Name der Hebebühne (z.B. Bühne 1)
`type`	string	Ja	Typ: two_post, four_post, scissor, pit
`position_x`	number	Nein	X-Position auf dem Hallenplan (cm)
`position_y`	number	Nein	Y-Position auf dem Hallenplan (cm)
`width_cm`	number	Nein	Breite in cm (Standard: 280)
`length_cm`	number	Nein	Länge in cm (Standard: 500)
`max_weight_kg`	number	Nein	Maximale Traglast in kg
`ev_compatible`	boolean	Nein	E-Auto kompatibel (Standard: false)
`notes`	string	Nein	Interne Notizen

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/hebebuehnen \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{
    "name": "Bühne 3",
    "type": "four_post",
    "width_cm": 300,
    "length_cm": 550,
    "max_weight_kg": 5000,
    "ev_compatible": true
  }'

Response201 Created

{
  "id": "neue-lift-uuid",
  "name": "Bühne 3",
  "type": "four_post",
  "is_available": true
}

PATCH/v1/hebebuehnen/:id

Aktualisiert Eigenschaften oder Position einer Hebebühne.

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Nein	Neuer Name
`position_x`	number	Nein	Neue X-Position (cm)
`position_y`	number	Nein	Neue Y-Position (cm)
`is_available`	boolean	Nein	Verfügbarkeit ein/aus
`ev_compatible`	boolean	Nein	E-Auto Kompatibilität

"token-method">curl "token-keyword">-X PATCH "token-url">https://api.schraubertermin.de/v1/hebebuehnen/l1a2b3... \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{"is_available": false}'

Response200 OK

{
  "id": "l1a2b3...",
  "name": "Bühne 1",
  "is_available": false
}

DELETE/v1/hebebuehnen/:id

Löscht eine Hebebühne. Aktive Zuweisungen werden vorher entfernt.

"token-method">curl "token-keyword">-X DELETE "token-url">https://api.schraubertermin.de/v1/hebebuehnen/l1a2b3... \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey'

Gibt 204 No Content bei Erfolg zurück.

POST/v1/hebebuehnen/:id/zuweisen

Weist eine Buchung einer Hebebühne zu. Die Buchung muss den Status confirmed, checked_in oder in_progress haben.

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`buchung_id`	uuid	Ja	ID der zuzuweisenden Buchung

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/hebebuehnen/l1a2b3.../zuweisen \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{"buchung_id": "b1a2c3d4..."}'

Response201 Created

{
  "id": "zuweisung-uuid",
  "lift_id": "l1a2b3...",
  "booking_id": "b1a2c3d4...",
  "status": "assigned",
  "zugewiesen_am": "2025-06-15T09: 00: 00Z"
}

POST/v1/hebebuehnen/:id/abweisen

Entfernt die aktive Buchungszuweisung von einer Hebebühne.

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/hebebuehnen/l1a2b3.../abweisen \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey'

Response200 OK

{
  "success": true
}

PATCH/v1/hebebuehnen/:id/status

Ändert den Status einer aktiven Zuweisung (z.B. von assigned auf in_progress).

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`status`	string	Ja	Neuer Status: assigned, in_progress

"token-method">curl "token-keyword">-X PATCH "token-url">https://api.schraubertermin.de/v1/hebebuehnen/l1a2b3.../status \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{"status": "in_progress"}'

Response200 OK

{
  "id": "zuweisung-uuid",
  "status": "in_progress",
  "gestartet_am": "2025-06-15T09: 10: 00Z"
}

POST/v1/hebebuehnen/:id/abschliessen

Schließt die aktive Arbeit auf einer Hebebühne ab. Die Buchung wird auf completed gesetzt.

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/hebebuehnen/l1a2b3.../abschliessen \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey'

Response200 OK

{
  "id": "zuweisung-uuid",
  "status": "completed",
  "abgeschlossen_am": "2025-06-15T10: 30: 00Z"
}

GET/v1/hebebuehnen/buchungen

Listet die heutigen Buchungen auf, die einer Hebebühne zugewiesen werden können.

"token-method">curl "token-keyword">-X GET "token-url">https://api.schraubertermin.de/v1/hebebuehnen/buchungen \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey'

Response200 OK

{
  "data": [
    {
      "id": "b1a2c3d4...",
      "uhrzeit": "09: 00",
      "dauer_minuten": 60,
      "status": "confirmed",
      "service_name": "Reifenwechsel",
      "kunde_name": "Max Mustermann",
      "kennzeichen": "B-AB 1234",
      "zugewiesen": false
    }
  ]
}

PATCH/v1/hebebuehnen/raum

Aktualisiert die Raumdimensionen der Werkstatthalle (für den visuellen Hallenplan).

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`floor_width_cm`	integer	Ja	Hallenbreite in cm (Min: 300, Max: 10000)
`floor_length_cm`	integer	Ja	Hallenlänge in cm (Min: 300, Max: 10000)

"token-method">curl "token-keyword">-X PATCH "token-url">https://api.schraubertermin.de/v1/hebebuehnen/raum \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{"floor_width_cm": 1500, "floor_length_cm": 1000}'

Response200 OK

{
  "floor_width_cm": 1500,
  "floor_length_cm": 1000
}