← gwada.app

Dokumentation

Anmelden

Events

Kommende und vergangene Veranstaltungen für Profil und Embed.

Liefert Events des Restaurants am API-Schlüssel — aufgeteilt in items (kommend inkl. kurzer Grace-Periode) und pastItems (vergangen). Beide Listen sind auf embed_max_items begrenzt (Standard 24).

Modul-ID im Schlüssel: events.

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

Endpunkt

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

Antwort (Auszug)

{
  "data": {
    "restaurantId": "uuid",
    "name": "Restaurant Name",
    "slug": "mein-slug",
    "accentHex": "#c45c26",
    "viewMode": "list",
    "connectedPlatforms": ["gwada", "facebook"],
    "items": [
      {
        "id": "evt-1",
        "platform": "gwada",
        "source": "gwada",
        "eventId": null,
        "title": "Jazz Night",
        "description": "Live-Musik …",
        "coverUrl": "https://…",
        "coverStoragePath": null,
        "startAt": "2026-08-15T18:00:00.000Z",
        "endAt": "2026-08-15T22:00:00.000Z",
        "ticketUrl": "https://…",
        "location": "Innenhof",
        "status": "published",
        "canEdit": false,
        "canDelete": false,
        "externalUrl": null,
        "createdAt": "2026-07-01T10:00:00.000Z",
        "publishedAt": "2026-07-01T10:00:00.000Z",
        "isPinned": true
      }
    ],
    "pastItems": [],
    "showAllPlatformFilter": true
  }
}

Plattformen

  • gwada
  • facebook
  • google_business
  • instagram
  • whatsapp_channel

Wichtige Felder

FeldBedeutung
itemsKommende Events (ggf. gepinnt zuerst)
pastItemsVergangene Events
startAt / endAtISO-8601; endAt optional
ticketUrl / locationOptionale Gast-Infos
coverUrlTitelbild-URL
externalUrlLink zur Plattform-Quelle

Hinweise

  • Keine Query-Parameter auf /api/v1/events
  • Instagram/WhatsApp erscheinen oft als Ankündigungs-Kanäle — native Sync vor allem Gwada/Facebook/Google
  • Max. Einträge über Events → Einstellungen steuern

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