Een sleutel is toegang tot één MANE
Alleen een eigenaar beheert servicesleutels via Instellingen → API & webhooks. Geef elke sleutel een herkenbare naam, bijvoorbeeld n8n · projectplanning. Kies 7, 30, 90 of 365 dagen geldigheid. Per werkruimte zijn maximaal twintig actieve sleutels toegestaan.
De volledige msk_-sleutel verschijnt één keer. De opgeslagen controlewaarde laat het origineel niet opnieuw zien. Ben je hem kwijt, maak dan een nieuwe sleutel en trek de oude in. Een servicesleutel kan zelf geen andere servicesleutels aanmaken.
Lezen en wijzigen zijn aparte rechten
Een scope bestaat uit een onderdeel en een handeling, bijvoorbeeld projects:read. Wijzigrechten geven niet automatisch leesrechten. Voor het lezen van revisies voeg je workspace:read of een passend leesrecht toe. Voor de veldcatalogus gebruik je schema:read.
| Scope | Wat dit toestaat |
|---|---|
| projects:read / projects:write | Projecten én trajecten lezen / wijzigen. |
| records:read / records:write | Alle relatie- en eigen dossierrecords lezen / wijzigen. |
| objects.installaties:read / :write | Alleen records van het object installaties, via /objects/installaties/records. |
| schema:read / schema:write | Objectinrichting bekijken / objecten en eigenschappen inrichten. |
| tasks:read / tasks:write | Taken lezen / wijzigen binnen een project. |
| relations:read / relations:write | Dossierverbanden lezen / toevoegen of verwijderen. |
| webhooks:read / webhooks:write | Webhookconfiguratie bekijken / beheren. |
| events:read | Gebeurtenissen ophalen als alternatief voor pushmeldingen. |
| files:read / files:write | Bestanden lezen / uploaden. |
Zo klein mogelijk kiezen
Wil je uitsluitend installaties synchroniseren, gebruik dan objects.installaties:read en eventueel :write. Geef niet ook records:read als je de sleutel wilt beperken tot dat object: records:read geeft toegang tot de brede verzameling.
Een exacte objectscope hoort bij de objectroute. Hij verleent geen toegang tot GET /records, andere objecten of de volledige catalogus. Je kunt schema:read afzonderlijk toevoegen als je toepassing de inrichting moet kunnen ontdekken.
Intrekken, vervangen en verlopen
Klik Intrekken bij de betreffende sleutel. Volgende verzoeken worden geweigerd. De sleutel blijft gekoppeld aan de eigenaar die hem aanmaakte: verliest die het eigenaarschap of wordt de MANE verwijderd, dan stopt de toegang ook.
Een webhook is een apart beheerd abonnement. Trek je een API-sleutel in, pauzeer of verwijder dan ook de bijbehorende webhook als de externe workflow geen meldingen meer mag ontvangen. Een webhookmelding die al onderweg is kan nog aankomen.
Vervang bij rotatie eerst het geheim in je externe toepassing, controleer een leesverzoek en trek daarna de oude sleutel in. Log geen Authorization-header en zet sleutels niet in URL-queryparameters.
Limieten en gebruik
De grens is 120 API-verzoeken per minuut per sleutel. Bij 429 wacht je volgens Retry-After. Schrijfverzoeken vereisen een actieve, schrijfbare werkruimte. Na afloop van een proef of abonnement kunnen bewaarde gegevens nog leesbaar zijn terwijl wijzigen wordt geweigerd.
Gewone API-dossierverzoeken voeren geen AI-generatie uit. Een skill opslaan is dus geen skill met MAINE laten schrijven. Kosten of limieten van Make en n8n zijn afhankelijk van je eigen abonnement daar.
Kom je er niet uit? Stel Jerryt je vraag.