Naar de inhoud
EddaOS

Helpcentrum › Instellingen en koppelingen

API-sleutels en webhooks

Koppel je eigen software of Zapier: gegevens lezen, relaties en reserveringen aanmaken en bericht krijgen bij gebeurtenissen.

Met een API-sleutel kan andere software gegevens van je bedrijf lezen, en met een sleutel voor lezen en schrijven ook relaties aanmaken en wijzigen en reserveringen aanmaken. Met een webhook krijgt die software meteen bericht als er iets gebeurt. Je beheert dit bij Instellingen → Koppelingen → API-sleutels (recht om de organisatie te beheren). Een uitlegpagina met alle gegevens staat bij API: uitleg.

Een sleutel maken

  1. Geef de sleutel een naam, bijvoorbeeld de software waarvoor hij is.
  2. Kies Alleen lezen of Lezen en schrijven. Kies alleen voor schrijven als de software echt iets in EddaOS moet zetten.
  3. Kopieer de sleutel direct. Hij is maar één keer te zien; EddaOS bewaart alleen een beveiligde afdruk.
  4. Gebruik hem in de andere software als Authorization: Bearer <sleutel>.

Je kunt hoogstens 10 sleutels tegelijk gebruiken. In de lijst zie je per sleutel het recht, de eerste tekens, wie hem maakte en wanneer hij voor het laatst is gebruikt. Intrekken kan altijd. Aanmaken, intrekken en alles wat een sleutel aanmaakt of wijzigt komen in het logboek.

Wat kun je lezen en schrijven?

  • Lezen: relaties, producten, definitieve verkoopfacturen, reserveringen (met de teamnaam, hoeveel gasten hun verklaring tekenden en de uitslag van het spel) en de activiteiten van Bookings, als lijst en als los item. Reserveringen kun je ook per activiteit opvragen.
  • Schrijven: een relatie aanmaken of wijzigen, een reservering aanmaken, en na het spel de uitslag en de groepsfoto bij een reservering zetten (bijvoorbeeld vanuit Odin Console; zie Een verklaring laten ondertekenen). Een reservering krijgt dezelfde controle als in EddaOS: is de tijd niet meer vrij, dan wordt hij niet gemaakt.
  • Taken en Odin Regie (met Edda Plan en Edda Bookings): de takenlijst lezen (te filteren op lijst en status), taken aanmaken, wijzigen, afvinken en verwijderen; props en voorraad lezen, het aantal bijwerken en een prop als op melden (dat geeft een taak op de takenlijst); en onderhoud lezen en de punten van een checklist afvinken, met een foto als die verplicht is. De ruimtes staan bij /ruimtes.

Verwijderen kan via de API alleen bij taken (ze gaan naar de prullenbak van Edda Plan); alles anders blijft bewaard.

Een onderdeel bestaat alleen als je bedrijf de bijbehorende add-on heeft.

Webhooks

  1. Vul bij Webhooks het adres in (alleen https, bijvoorbeeld van Zapier) en kies de gebeurtenissen, bijvoorbeeld een nieuwe reservering, een betaalde factuur of een afgevinkte taak. Je kiest uit dezelfde gebeurtenissen als bij de automatische mails en automatiseringen, van de add-ons die aan staan.
  2. Kopieer het geheim. Daarmee controleert de andere software dat een bericht echt van EddaOS komt.
  3. Klik op Testen om een testbericht te sturen.

Komt een bericht niet aan, dan probeert EddaOS het een paar keer opnieuw. Na veel mislukte berichten achter elkaar gaat de webhook uit; zet hem dan na het oplossen met Weer aanzetten aan. Onder elke webhook zie je de laatste berichten. Adressen in een intern netwerk zijn niet toegestaan.

Klopt er iets niet, of mis je iets? Laat het ons weten via Support. Werkt iets niet? Kijk op de statuspagina.

Nog een vraag? We helpen je graag

Kijk eerst in het Helpcentrum, of neem contact met ons op.

EddaOS gebruikt alleen noodzakelijke cookies: om je ingelogd te houden en formulieren te beveiligen. We plaatsen ze pas na je akkoord. Zonder akkoord kun je de website bekijken, maar niet inloggen of een formulier versturen. Meer over cookies