Gå til innhold

ClubsiteCMS-integrasjon – Skisse

Målet er å konsumere et Google Apps Script-webapp-endepunkt som returnerer JSON, og eksponere data i ClubsiteCMS som en app-modul (for eksempel liste over golfbiler, status, osv.).

API-kontrakt (placeholder)

  • Base: https://script.google.com/macros/s/<DEPLOYMENT_ID>/exec
  • Auth: Query key=<SECRET> (bytt senere til mer robust mekanisme om ønskelig)
  • GET ?action=ping&key=...{ ok: true, action: 'ping', ts: '...' }
  • GET ?action=list&key=...{ ok: true, items: [ { id, name, status } ] }

Feltmapping (eksempel)

  • id → unik identifikator i CMS
  • name → tittel/visningsnavn
  • status → visningsbadge: available/in-use/maintenance

Presentasjon i ClubsiteCMS

  • Komponent: Liste/Widget som viser alle elementer fra items
  • Filtrering: Valgfritt filter på status
  • Tomtilstand: Tekst når items er tom

Konfigurasjon i appen

  • BASE_URL (tekst)
  • API_KEY (hemmelig)
  • DEFAULT_ACTION (f.eks. list)
  • Oppdateringsintervall (sekunder) om polling ønskes

Feilhåndtering

  • Vis brukervennlig feilmelding ved ok: false eller nettverksfeil
  • Logg teknisk feildetalj til konsoll/adminpanel

Neste steg

  • Erstatt placeholder-felter når vi får faktisk responsstruktur.
  • Evt. legge til POST-operasjoner for booking/oppdatering.