Het Developer Center is waar je Exayard verbindt met je eigen code en tools. Open het via Instellingen en vervolgens Developer. Hier maak je API-sleutels aan, registreer je webhook-endpoints en bekijk je een live log van elk API-verzoek. Alleen organisatiebeheerders hebben toegang tot deze pagina.
API-sleutels
Een API-sleutel authenticeert verzoeken aan de Exayard-API. Sleutels horen bij je organisatie, dus het juiste account wordt automatisch geselecteerd en er is geen organisatie-ID die je hoeft mee te geven.
Open het tabblad API-sleutels in de kaart Credentials en klik op de knop +. Geef de sleutel een Naam en kies vervolgens de Scopes. Selecteer Alle om elke scope toe te kennen, of Specifiek om afzonderlijke rechten te kiezen. Scopes volgen een splitsing tussen lezen en schrijven per resource, zoals read:projects en write:estimates. De scope admin:org verleent volledige toegang. Kies de minimale scopes die je integratie nodig heeft.
Exayard toont de volledige sleutel één keer, direct nadat je hem hebt aangemaakt. Kopieer die dan, want hij wordt nooit meer getoond. Daarna verschijnt elke sleutel met zijn naam, een gemaskeerd voorbeeld zoals ak_••••1234 en de datum waarop hij voor het laatst is gebruikt.
Gebruik het potloodpictogram om een sleutel te hernoemen of de scopes ervan te wijzigen. Gebruik het prullenbakpictogram om hem te Intrekken. Intrekken is permanent en elke integratie die die sleutel gebruikt, stopt onmiddellijk met werken.
Dezelfde sleutel authenticeert de no-code-integraties. Zie Exayard verbinden met Zapier, Exayard verbinden met Make en Exayard verbinden met n8n. Voor toegang van agents en AI-editors, zie Verbinden met Claude en andere AI-tools.
Webhooks
Een webhook zorgt ervoor dat Exayard je server op de hoogte stelt wanneer er iets gebeurt. Open het tabblad Webhooks en klik op + om een endpoint toe te voegen. Voer de URL in die bezorgingen moet ontvangen en een optionele Beschrijving.
Kies op welke Gebeurtenissen je je wilt abonneren. Selecteer Alle om elke gebeurtenis te ontvangen, of Specifiek om uit de lijst te kiezen:
Gebeurtenis | Vindt plaats wanneer |
| Een project wordt aangemaakt |
| Een project wordt gewijzigd |
| Een project wordt gearchiveerd |
| Een metingbeoordeling begint |
| Een beoordeling is voltooid |
| Een beoordeling wordt goedgekeurd |
| Een beoordeling wordt geannuleerd |
| Een calculatie wordt gegenereerd |
| Een offerte wordt gegenereerd |
| Een geüpload bestand is klaar met verwerken |
Wanneer je een endpoint aanmaakt, toont Exayard één keer een ondertekeningsgeheim. Kopieer het dan, want het wordt niet meer getoond.
Webhook-bezorgingen beveiligen
Elke bezorging draagt een header Exayard-Signature in de vorm t=<unix>,v1=<digest>. Exayard bouwt de handtekening op door de tijdstempel en de hoofdtekst van het verzoek samen te voegen en die vervolgens te ondertekenen met HMAC-SHA256 met behulp van je endpoint-geheim.
Om een bezorging te verifiëren, herbereken je de handtekening met je geheim, bevestig je dat de tijdstempel binnen vijf minuten van nu ligt, en vergelijk je de digests. Mislukte bezorgingen worden over een periode van ongeveer drie dagen opnieuw geprobeerd met exponentiële backoff.
Om een endpoint te bewerken, klik je op het potloodpictogram. Je kunt de URL, beschrijving en gebeurtenissen wijzigen en de Status instellen op Actief of Gepauzeerd. Gepauzeerde endpoints ontvangen geen bezorgingen meer. Hetzelfde dialoogvenster heeft een knop Geheim roteren. Roteren geeft een nieuw geheim uit en het oude stopt onmiddellijk met werken, dus werk je server bij voordat je roteert. Het prullenbakpictogram verwijdert een endpoint en beëindigt alle bezorgingen daarnaartoe.
Snel aan de slag
De kaart Snel aan de slag bevat een kant-en-klare prompt voor een AI-editor zoals Claude of Cursor. Klik op Prompt kopiëren en plak die in je editor. De prompt bevat de basis-URL van de API, het authenticatieformaat, de scope-woordenlijst en het webhook-ondertekeningsschema, zodat de AI een werkende integratie kan opzetten en je om de details vraagt die hij nodig heeft.
Documentatie
De kaart Documentatie linkt naar de volledige developer-documentatie en de OpenAPI-spec, die elke route en elk schema beschrijft. MCP verbinden opent de installatie voor het rechtstreeks verbinden van AI-agents met Exayard.
Logs
De sectie Logs registreert je meest recente API-verzoeken over zowel de REST-API als MCP. Elke rij toont de methode, het pad, de responsestatus en de latentie. Selecteer een rij om alle details ervan te zien, inclusief de verzoek-ID en de hoofdteksten van het verzoek en de respons. Gebruik de logs om te bevestigen dat een oproep heeft gewerkt of om een mislukkende integratie te debuggen.
