Bewertungen

Lesen Sie Kundenbewertungen und antworten Sie darauf. Bewertungen werden von Kunden nach abgeschlossenen Buchungen abgegeben.

Auf dieser Seite

GET /v1/bewertungen GET /v1/bewertungen/:id POST /v1/bewertungen/:id/antwort

GET/v1/bewertungen

Listet alle Bewertungen Ihrer Werkstatt auf, sortiert nach Datum (neueste zuerst).

Query-Parameter

Name	Typ	Pflicht	Beschreibung
`sterne`	integer	Nein	Filter nach Sternebewertung (1-5)
`beantwortet`	boolean	Nein	Filter: nur beantwortete/unbeantwortete
`page`	integer	Nein	Seitennummer (Standard: 1)
`per_page`	integer	Nein	Einträge pro Seite (Standard: 25)

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

Response200 OK

{
  "data": [
    {
      "id": "rev1a2...",
      "sterne": 5,
      "kommentar": "Super Service, sehr freundlich!",
      "kunde_name": "Max Mustermann",
      "service_name": "Reifenwechsel",
      "antwort": null,
      "erstellt_am": "2025-06-16T10: 00: 00Z"
    },
    {
      "id": "rev2b3...",
      "sterne": 4,
      "kommentar": "Gute Arbeit, aber etwas lange Wartezeit.",
      "kunde_name": "Anna Schmidt",
      "service_name": "HU/AU",
      "antwort": "Vielen Dank für Ihr Feedback! Wir arbeiten an kürzeren Wartezeiten.",
      "antwort_am": "2025-06-15T14: 00: 00Z",
      "erstellt_am": "2025-06-15T08: 00: 00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 67,
    "total_pages": 3
  },
  "zusammenfassung": {
    "durchschnitt": 4.6,
    "gesamt": 67
  }
}

GET/v1/bewertungen/:id

Ruft eine einzelne Bewertung mit Details ab.

Name	Typ	Pflicht	Beschreibung
`id`	uuid	Ja	ID der Bewertung

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

Response200 OK

{
  "id": "rev1a2...",
  "sterne": 5,
  "kommentar": "Super Service, sehr freundlich!",
  "kunde": {
    "id": "k1a2...",
    "name": "Max Mustermann"
  },
  "buchung": {
    "id": "b1a2...",
    "datum": "2025-06-15",
    "service": "Reifenwechsel"
  },
  "antwort": null,
  "erstellt_am": "2025-06-16T10: 00: 00Z"
}

POST/v1/bewertungen/:id/antwort

Antwortet öffentlich auf eine Kundenbewertung. Die Antwort ist für alle Besucher der Werkstattseite sichtbar.

Body-Parameter

Name	Typ	Pflicht	Beschreibung
`antwort`	string	Ja	Ihre öffentliche Antwort auf die Bewertung

"token-method">curl "token-keyword">-X POST "token-url">https://api.schraubertermin.de/v1/bewertungen/rev1a2.../antwort \
  "token-flag">-H 'Authorization: Bearer sk_live_IhrApiKey' \
  "token-flag">-H 'Content-Type: application/json' \
  "token-flag">-d '{"antwort": "Vielen Dank für Ihre tolle Bewertung! Wir freuen uns auf Ihren nächsten Besuch."}'

Response200 OK

{
  "id": "rev1a2...",
  "antwort": "Vielen Dank für Ihre tolle Bewertung! Wir freuen uns auf Ihren nächsten Besuch.",
  "antwort_am": "2025-06-16T12: 00: 00Z"
}