API-tokens laten je je eigen scripts, tools of automatiseringen koppelen aan InfraNest, met dezelfde acties die je anders zelf in de app zou uitvoeren. Dit artikel is voor iedereen die taken wil automatiseren in plaats van ze handmatig uit te voeren.
Overzicht
- InfraNest heeft een volledige REST API, dus alles wat je in de app kunt doen, kun je ook via automatisering doen.
- Je krijgt toegang tot de API door een API-tokens-item aan te maken, dat werkt als een sleutel.
- Elk token kan precies beperkt worden tot wat het mag doen, en voor hoe lang.
Een token aanmaken
- Ga naar API-tokens en selecteer Aanmaken.
- Geef het token een naam, kies de bevoegdheden (wat het mag doen), en stel eventueel een vervaldatum in.
- Selecteer Kopiëren om het token direct te kopiëren.
WarningKopieer het token nu — het wordt maar één keer weergegeven. Daarna zie je alleen nog een hint van de laatste paar tekens, en het kan niet meer opnieuw worden weergegeven.
Bevoegdheden kiezen
Bevoegdheden bepalen wat elk token kan zien of wijzigen. Voor elk gebied kun je lees- of schrijftoegang verlenen, en er is ook een alleen-lezen preset en een volledige-toegangsoptie. Geef een token als vaste regel alleen wat het daadwerkelijk nodig heeft.
Elk gebied omvat meer dan de naam suggereert:
- Domains & Contacts — domeinen, contacten, overdrachten, nameservers
- DNS — zones, records, sjablonen
- Cloud Infrastructure — servers, volumes, snapshots, netwerken, firewalls, load balancers, cloud-credentials
- Monitoring — uptimechecks, incidenten, onderhoud, statuspagina's, plus Certificaten en webhooks, automatiseringen, integraties en tags
- Drop Catch — gevolgde domeinen en drop-catch-pogingen
- Members & Teams — leden, uitnodigingen, rollen, single sign-on
- Billing — abonnement, facturen, betaalmethoden, factuurgegevens (alleen-lezen)
- Audit Log — de auditlog van je organisatie (alleen-lezen)
- Data export & import — je data exporteren, en importeren vanuit een bestand
NoteCertificaten en webhooks zijn geen apart gebied — ze horen bij Monitoring, dus een token dat een van beide nodig heeft, heeft toegang tot Monitoring nodig. Billing en de Audit Log zijn via de API altijd alleen-lezen — een abonnement wijzigen of een factuur betalen kan alleen door iemand die is ingelogd in de app.
Tokens beheren
- Ga naar API-tokens om je bestaande tokens te bekijken.
- Controleer de datum van laatste gebruik van elk token om te zien of het nog actief is.
- Selecteer Verwijderen bij elk token dat je wilt intrekken — dit gaat direct in.
TipDe volledige endpoint-referentie staat in de app — selecteer View full API documentation op de pagina API-tokens.
Problemen oplossen
- Krijg je het antwoord "try again shortly"? Sommige acties, zoals handmatige synchronisaties en "check now", hebben een rate limit per organisatie om het platform te beschermen. Wacht even en probeer het opnieuw.
- Token verloren? Je kunt het niet meer bekijken — maak een nieuw token aan en verwijder het oude.
Was dit artikel nuttig?