Spørgsmål og svar

Ja. Gecko har et REST API, som andre systemer kan hente data fra og skrive data til: kunder, bookinger, kalendere, ydelser, kasse og varer, værdikort, events, skemaer mv. Adgangen styres med en API-nøgle, som du selv opretter inde i Gecko.

1. API-adgang skal først slås til på din aftale

API-adgang er ikke slået til som standard. Er den ikke aktiveret, findes afsnittet API nøgler slet ikke i indstillingerne, og så kan du hverken se eller oprette en nøgle. Kontakt Gecko support og bed om at få aktiveret API-adgang.

2. Sådan opretter du en API-nøgle

1. Log ind som super-admin. Kun super-admin kan oprette og rette API-nøgler.
2. Gå til Indstillinger > [Generelt] Adgangs- og sikkerhedsindstillinger.
3. Find afsnittet API nøgler og klik Opret ny API nøgle.
4. Udfyld Navn - brug navnet på det system, der skal have adgang - og Ansvarlig e-mail, så vi kan kontakte den rette, hvis der opstår spørgsmål om nøglens brug.
5. Skal nøglen kun kunne noget bestemt, sæt flueben i Begræns API-nøglens adgang til specifikke endpoints og vælg Læse, Skrive eller begge dele for hvert område. Uden flueben har nøglen adgang til alle endpoints.
6. Klik Opret API-nøgle.

Kopiér api-nøglen med det samme. Den vises kun én gang - i vinduet lige efter oprettelsen. Lukker du vinduet, kan tokenen ikke hentes frem igen, og så skal der oprettes en ny nøgle.

3. Dokumentationen til udvikleren

Den fulde tekniske dokumentation ligger på installationen selv: åbn https://www.geckobooking.dk/api/v1 i en browser. Her står alle endpoints, felter, eksempler og fejlkoder.

Skal Gecko i stedet sende besked til jer? Så er det webhooks du skal bruge

REST API'et bruges, når jeres system selv henter eller sender data. Skal Gecko omvendt sende besked af sig selv, når noget sker - for eksempel når en booking oprettes eller et salg gennemføres - er det webhooks, I skal bruge. De sættes op under Indstillinger > [Generelt] Webhook indstillinger.