Bewertungen
Öffentliche Bewertungen und Zusammenfassung über verbundene Plattformen.
Liefert sichtbare Bewertungen (Gwada, Google, Facebook, TripAdvisor — je nach Verbindung) plus Summary mit Durchschnitt, Median und Sterne-Verteilung.
Modul-ID im Schlüssel: reviews. Auf v1 gibt es keine page-/paginate-Parameter — die Antwort enthält den öffentlichen Feed ohne Pagination-Objekt.
Methoden: GET, OPTIONS · Endpunkt: GET /api/v1/reviews
Endpunkt
curl -s "https://gwada.app/api/v1/reviews" \ -H "Authorization: Bearer gwada_sk_live_…" \ -H "Accept: application/json"
Antwort (Auszug)
{
"data": {
"restaurantId": "uuid",
"name": "Restaurant Name",
"slug": "mein-slug",
"accentHex": "#c45c26",
"viewMode": "grid",
"connectedPlatforms": ["gwada", "google"],
"reviews": [
{
"id": "rev-1",
"platform": "gwada",
"rating": 5,
"comment": "Sehr gut!",
"authorName": "Anna",
"createdAt": "2026-07-01T12:00:00.000Z",
"reply": null
}
],
"summary": {
"count": 10,
"average": 4.5,
"median": 5,
"distribution": { "1": 0, "2": 0, "3": 1, "4": 2, "5": 7 }
}
}
}Wichtige Felder
| Feld | Bedeutung |
|---|---|
| connectedPlatforms | Plattformen mit Daten in diesem Feed |
| reviews[].platform | gwada | google | facebook | tripadvisor |
| reviews[].rating | Sterne (typisch 1–5) |
| reviews[].reply | Öffentliche Antwort, falls vorhanden |
| summary.average / median | Kennzahlen über den sichtbaren Satz |
| summary.distribution | Anzahl je Sterne-Stufe als String-Keys „1“…„5“ |
| viewMode | Empfohlene Darstellung aus Embed-Einstellungen (z. B. grid) |
Hinweise
- Nur öffentlich sichtbare Bewertungen — interne Status bleiben draußen
- Keine Query-Parameter auf /api/v1/reviews
- Nicht verbundene Plattformen erscheinen nicht in connectedPlatforms
Fehler
Auth- und Limit-Fehler sind einheitlich — siehe Rate Limits & Fehler. Typisch: 401 invalid_api_key, 403 module_not_enabled, 403 restaurant_not_published, 404 not_found, 429 rate_limit_exceeded.