← gwada.app

Dokumentation

Anmelden

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

FeldBedeutung
connectedPlatformsPlattformen mit Daten in diesem Feed
reviews[].platformgwada | google | facebook | tripadvisor
reviews[].ratingSterne (typisch 1–5)
reviews[].replyÖffentliche Antwort, falls vorhanden
summary.average / medianKennzahlen über den sichtbaren Satz
summary.distributionAnzahl je Sterne-Stufe als String-Keys „1“…„5“
viewModeEmpfohlene 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.

Weiterlesen