← gwada.app

Dokumentation

Anmelden

Galerie

Öffentliche Galerie-Bilder, Highlights und Plattform-Liste.

Liefert Galerie-Einträge und Highlights. Im Gegensatz zu manchen Public-Profile-Routen akzeptiert /api/v1/gallery keine page-/platform-Query — es wird die erste Seite mit pageSize 24 zurückgegeben.

Modul-ID im Schlüssel: gallery. totalCount zeigt die Gesamtzahl; für weitere Seiten nutze derzeit das Embed/Public-Profile oder plane Client-seitig mit dem ersten Page-Satz.

Methoden: GET, OPTIONS · Endpunkt: GET /api/v1/gallery

Endpunkt

curl -s "https://gwada.app/api/v1/gallery" \
  -H "Authorization: Bearer gwada_sk_live_…" \
  -H "Accept: application/json"

Antwort (Auszug)

{
  "data": {
    "restaurantId": "uuid",
    "name": "Restaurant Name",
    "slug": "mein-slug",
    "accentHex": "#c45c26",
    "items": [
      {
        "id": "img-1",
        "platform": "gwada",
        "source": "gwada",
        "itemId": null,
        "title": "Ambiente",
        "caption": null,
        "category": "ambiente",
        "categoryLabel": "Ambiente",
        "mediaKind": "image",
        "previewUrl": "https://…",
        "fullUrl": "https://…",
        "thumbUrl": "https://…",
        "width": null,
        "height": null,
        "storagePath": null,
        "mimeType": null,
        "sizeBytes": null,
        "createdAt": "2026-07-01T10:00:00.000Z",
        "canEdit": false,
        "canDelete": false,
        "externalUrl": null,
        "externalId": "…",
        "parentExternalId": null,
        "isPinned": false
      }
    ],
    "highlights": [
      {
        "id": "hl-1",
        "platform": "gwada",
        "title": "Favoriten",
        "coverUrl": "https://…",
        "itemIds": ["img-1"],
        "items": []
      }
    ],
    "totalCount": 100,
    "availablePlatforms": ["gwada", "instagram"],
    "page": 1,
    "pageSize": 24
  }
}

Plattformen

  • gwada
  • facebook
  • instagram
  • google_business
  • tripadvisor

Wichtige Felder

FeldBedeutung
itemsGalerie-Einträge der aktuellen Seite
previewUrl / fullUrl / thumbUrlBild-URLs für Anzeige
category / categoryLabelOptionale Kategorie
highlightsKuratierte Gwada-Highlights
totalCountGesamtanzahl über alle Seiten
page / pageSizeAktuelle Seite — v1 liefert page=1, pageSize=24
availablePlatformsPlattformen mit Galerie-Inhalten

Hinweise

  • Keine Query-Parameter — Plattform-Filter musst du clientseitig auf items anwenden
  • Public-Payload entfernt interne Storage-Details wo möglich (storagePath oft null)
  • Highlights referenzieren Gwada-Bilder über itemIds

Gut zu wissen

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