Services

Verwalten Sie die von Ihrer Werkstatt angebotenen Leistungen und deren Preise.

Auf dieser Seite

GET /v1/services GET /v1/services/:id POST /v1/services PATCH /v1/services/:id DELETE /v1/services/:id

GET/v1/services

Listet alle aktiven Services Ihrer Werkstatt mit Preisen und Dauer auf.

Query-Parameter

Name	Typ	Pflicht	Beschreibung
`kategorie`	string	Nein	Filter nach Kategorie-Slug (z.B. reifenservice, inspektion)

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

Response200 OK

{
  "data": [
    {
      "id": 42,
      "service_id": 1,
      "service_name": "Reifenwechsel",
      "service_slug": "reifenwechsel",
      "kategorie": "Reifenservice",
      "preis": 4900,
      "dauer_minuten": 30,
      "beschreibung": "4 Reifen wechseln inkl. Auswuchten"
    },
    {
      "id": 43,
      "service_id": 3,
      "service_name": "HU/AU",
      "service_slug": "hu-au",
      "kategorie": "Prüfung",
      "preis": 14900,
      "dauer_minuten": 60,
      "beschreibung": null
    }
  ]
}

GET/v1/services/:id

Ruft einen einzelnen Werkstatt-Service ab.

Name	Typ	Pflicht	Beschreibung
`id`	integer	Ja	ID des Workshop-Services

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

Response200 OK

{
  "id": 42,
  "service_id": 1,
  "service_name": "Reifenwechsel",
  "service_slug": "reifenwechsel",
  "kategorie": "Reifenservice",
  "preis": 4900,
  "dauer_minuten": 30,
  "beschreibung": "4 Reifen wechseln inkl. Auswuchten",
  "aktiv": true
}

POST/v1/services

Aktiviert einen Service aus dem Plattform-Katalog für Ihre Werkstatt mit individuellem Preis.

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`service_id`	integer	Ja	ID des Services aus dem Plattform-Katalog
`preis`	integer	Ja	Preis in Cent (z.B. 4900 = 49,00 EUR)
`dauer_minuten`	integer	Ja	Geschätzte Dauer in Minuten
`beschreibung`	string	Nein	Individuelle Beschreibung

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/services \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{
    "service_id": 5,
    "preis": 7900,
    "dauer_minuten": 45,
    "beschreibung": "Inklusive Filterwechsel"
  }'

Response201 Created

{
  "id": 44,
  "service_id": 5,
  "service_name": "Ölwechsel",
  "preis": 7900,
  "dauer_minuten": 45,
  "beschreibung": "Inklusive Filterwechsel"
}

PATCH/v1/services/:id

Aktualisiert Preis, Dauer oder Beschreibung eines Werkstatt-Services.

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`preis`	integer	Nein	Neuer Preis in Cent
`dauer_minuten`	integer	Nein	Neue Dauer in Minuten
`beschreibung`	string	Nein	Neue Beschreibung

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

Response200 OK

{
  "id": 42,
  "service_name": "Reifenwechsel",
  "preis": 5500,
  "aktualisiert_am": "2025-06-10T16: 00: 00Z"
}

DELETE/v1/services/:id

Deaktiviert einen Service. Bestehende Buchungen mit diesem Service bleiben erhalten.

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

Gibt 204 No Content bei Erfolg zurück.