De API voor afspraakplanning die openstaat voor al uw tools
Tokens met scopes, ondertekende webhooks, OAuth-applicaties, Zapier en Make. Uw boekingen stromen naar de plek waar u werkt.
Een API voor afspraakplanning komt van pas zodra uw boekingen ook buiten de boekingstool moeten leven: in vakspecifieke software, een klantportaal, een datawarehouse of een automatiseringstool. Zonder API blijft alleen handmatig exporteren en overtypen over.
Waarom een complete API voor afspraakplanning
Artibox Calendar biedt een publieke REST-API op de routes /api/v1: afspraaktypen, beschikbaarheid, boekingen, peilingen, eenmalige links, verzonden links, webhooks. Ze volgt dezelfde regels als de applicatie: dezelfde rechten, dezelfde scheiding tussen organisaties, dezelfde boeking met vergrendeling. Wat een token mag, mag zijn lid ook; niets meer.
Voor teams zonder developer verbinden de connectoren voor Zapier en Make uw afspraken met uw tools zonder één regel code. En voor HubSpot, Salesforce of Pipedrive staan de CRM-integraties al klaar.
Zo werkt het
Maak een persoonlijk token aan
Kies de scopes (boekingen lezen, typen schrijven…). Het token begint met rdv_pat_.
Roep de API aan
Stuur het token mee in de header x-api-key. Buiten de scopes wordt de aanroep geweigerd.
Abonneer u op events
Geef een webhookadres op en de events die u interesseren.
Volg de leveringen
Het webhooklogboek toont elke verzending; u kunt testen en opnieuw versturen.
Een API gebouwd voor productie
Tokens met scopes
Elk persoonlijk token heeft precieze scopes: de gebruiker lezen, de organisatie lezen of beheren, typen lezen of schrijven, beschikbaarheid lezen, boekingen lezen of schrijven, links schrijven, webhooks beheren. Een aanroep buiten de scopes krijgt een 403-antwoord. Een token kan nooit een ander token aanmaken.
Duidelijke limieten
Elk token kan 100 aanroepen per minuut doen. Lijsten worden gepagineerd op paginanummer. Aanmaakverzoeken accepteren een header Idempotency-Key, die 24 uur wordt bewaard: een aanroep die na een netwerkonderbreking opnieuw wordt verstuurd, maakt geen dubbel record aan. Afspraken die via de API zijn aangemaakt, hebben de herkomst „api”.
Dezelfde engine als de boekingspagina
Een boeking via de API volgt dezelfde regels als op uw online boekingspagina: vooraankondiging, buffers, maximum per dag, gekoppelde agenda's. Is het tijdslot net geboekt, dan is het antwoord een duidelijke weigering, nooit een dubbele boeking.
Ondertekende webhooks
De events
Uw applicatie wordt op de hoogte gebracht wanneer een afspraak wordt aangemaakt, verzet, geannuleerd of vastgesteld, wanneer een genodigde stemt in een peiling of een peiling wordt bevestigd, en wanneer een type wijzigt. Elke verzending is ondertekend (header X-Signature): u controleert of ze echt van Artibox Calendar komt.
Betrouwbare leveringen
Reageert uw server niet, dan wordt de levering opnieuw geprobeerd, van één minuut tot twaalf uur. Na 20 opeenvolgende mislukkingen wordt het abonnement uitgeschakeld. Het logboek bewaart 30 dagen aan leveringen; met de ene knop verstuurt u een testevent, met de andere verstuurt u een levering opnieuw. Om veiligheidsredenen kunnen webhooks geen adres op het interne netwerk bereiken.
OAuth voor softwareleveranciers
Ontwikkelt u een tool die door andere organisaties wordt gebruikt? Registreer een OAuth-applicatie onder Instellingen › Integraties. Uw gebruikers zien een toestemmingsscherm, waarna uw applicatie een eenmalige code ontvangt, 10 minuten geldig en beschermd met PKCE (S256). Het toegangstoken is 2 uur geldig; het vernieuwingstoken roteert bij elk gebruik, en hergebruik ervan trekt de volledige toegang in. Elk lid trekt een toegang in via „Verbonden applicaties”.
Zonder code: Zapier, Make en de widget
Zapier en Make
De connectoren voor Zapier en Make worden gekoppeld als OAuth-applicaties: start een scenario bij elke nieuwe afspraak, verstuur een boekingslink vanuit een andere tool, zoek een afspraak op e-mailadres.
De integratiekit
Het script widget.js voegt een boekingsknop of -link toe aan uw website. De boeking opent in een apart venster. Trackingparameters (utm_*, gclid, fbclid, ref) worden bij de afspraak bewaard, en een ondertekende context kan de boeking vanuit uw tool vooraf invullen.
Pakketten en beveiliging
De API (persoonlijke tokens, OAuth-applicaties) en de connectoren voor Zapier en Make maken deel uit van het pakket Pro; webhooks van het pakket Team. De details staan op de pagina prijzen. Alleen de hash van tokens wordt bewaard, nooit het token in leesbare vorm: zie beveiliging en AVG.
Om te beginnen volgt u de helpartikelen API en tokens (FR) en webhooks (FR). Twijfelt u tussen de twee automatiseringstools? Lees Zapier of Make (FR). Definities: API (FR), webhook (FR).
Voor wie
Salesteams
Afspraken verbinden met uw sales- en rapportagetools.
Bureaus (FR)
Afspraakplanning integreren in de websites en tools van uw klanten.
Recruitment (FR)
Sollicitatiegesprekken aanmaken vanuit uw applicant tracking system.
Trainers (FR)
Inschrijvingen voor sessies doorsturen naar uw opleidingsbeheersysteem.
Veelgestelde vragen
Hoe authenticeer ik me bij de API voor afspraakplanning?
Met een persoonlijk token (rdv_pat_…) of een OAuth-toegangstoken, verstuurd in de header x-api-key. Elk token heeft zijn eigen scopes.
Wat zijn de limieten voor aanroepen?
100 aanroepen per minuut per token. Aanmaakverzoeken accepteren een header Idempotency-Key, die 24 uur wordt bewaard.
Hoe controleer ik of een webhook echt van Artibox Calendar komt?
Elke verzending is ondertekend in de header X-Signature. Controleer de handtekening voordat u de inhoud verwerkt.
Wat gebeurt er als mijn server niet beschikbaar is?
De levering wordt opnieuw geprobeerd van één minuut tot twaalf uur. Na 20 mislukkingen wordt het abonnement uitgeschakeld; u kunt leveringen opnieuw versturen vanuit het logboek, dat 30 dagen wordt bewaard.
In welk pakket zit de API?
De API, Zapier en Make vanaf het pakket Pro; webhooks vanaf het pakket Team. Zie de prijzen.
Verbind uw afspraken met uw tools
Maak gratis uw account aan en daarna uw eerste API-token.
Account aanmaken