API-sleutels en de API
Laat een ander systeem uw IDup-gegevens lezen en schrijven onder een sleutel die u kunt vernieuwen of verwijderen, en vind de API-gids.
Een API-sleutel is een wachtwoord dat bij een programma hoort in plaats van bij een persoon. Behandel het op dezelfde manier: geef er één per systeem uit en vervang het wanneer dat systeem verandert.
Maak een sleutel
- Open API → API-beheer en druk op Nieuwe sleutel.
- Geef het een naam die aangeeft welk systeem het gebruikt.
- Kies zijn Machtigingen: Volledige toegang, of alleen de gebieden die het systeem nodig heeft. De meeste gebieden onderscheiden lezen, creëren en wijzigen.
- Kies een vervaldatum, of geen.
- Gebruik Weergeven en Kopiëren op de sleutelkaart om de sleutel aan het oproepsysteem te overhandigen. Het systeem stuurt het in de authtoken koptekst.
Elke sleutelkaart toont de permissies, de aanmaakdatum, Laatst gebruikt en een badge zoals 'actief' of 'vervalt over 5 dagen'.
Een sleutel vernieuwen voordat deze verloopt
Veertien dagen voordat een sleutel verloopt, ontvangt u een melding in de bel. Druk op Vernieuwen op de sleutelkaart en kies de nieuwe vervaldatum. IDup creëert een nieuwe sleutel met dezelfde rechten. Kopieer deze onmiddellijk, want dit scherm verschijnt slechts één keer. De oude sleutel blijft geldig tot zijn eigen vervaldatum, zodat u het systeem zonder onderbreking kunt overschakelen.
De gebieden die u kunt bereiken
De API dekt uw klantgegevens en, afhankelijk van uw plan, eigendommen en verhuur, zoekprofielen, belastingdossiers, trusteebestanden, boekhouding, loonruns en bonnenscanning. AI Studio en de inbox hebben hun eigen gebieden. De API-gids vermeldt alleen de gebieden die uw plan omvat.
De API-gids
Open de Documentatie tab op de API-beheerpagina, of API → API-gids. Elk gebied toont zijn velden, voorbeeldverzoeken die u kunt kopiëren, voorbeeldantwoorden en foutcodes.
Webhooks en andere interfaces
- De Webhooks tab stuurt gebeurtenissen naar uw systeem zodra ze zich voordoen — zie Stuur gebeurtenissen naar uw eigen systeem met webhooks.
- Als de Customer API is ingeschakeld, een Klanten API-instellingen tab opent de instellingen, bijvoorbeeld of klanten zich via de API mogen registreren.
- Automatisering / Workflows → Technische interface geeft een token uit voor de GraphQL-interface.
- AI Studio → Persoonlijke API-sleutels is een aparte set sleutels.
Het veilig houden
- Eén sleutel per systeem, nooit een gedeelde.
- Geef een sleutel alleen de rechten die het systeem nodig heeft.
- Stel een vervaldatum in en vernieuw volgens een schema.
- Verwijder een sleutel zodra iemand die deze kende vertrekt, of het systeem wordt uitgeschakeld.
Niets wordt gevolgd — de knoppen openen alleen een bericht zodat u ons kunt vertellen wat er ontbrak.
