API-sleutels

Maak API-sleutels aan om je eigen systemen of tools zoals Zapier en Make aan MemBirds te koppelen, kies wat een sleutel mag en trek sleutels in.

Met een API-sleutel kan een ander systeem via de MemBirds API met je gegevens werken: bijvoorbeeld nieuwe bestellingen ophalen, leden aanmaken of iemand toegang tot een product geven. Je beheert sleutels onder Instellingen → API-sleutels (in de groep Geavanceerd).

Een API-sleutel aanmaken

Naam

Vul onder API-sleutel aanmaken de Naam van de token in, bijvoorbeeld de tool of persoon die hem gaat gebruiken. De naam is alleen voor jezelf.

Rechten

Vink aan wat de sleutel mag (zie Rechten). Kies er minstens één.

Aanmaken en kopiëren

Klik op Toevoegen. Het venster Kopieer de API-sleutel toont de sleutel. Kopieer hem direct en bewaar hem op een veilige plek, bijvoorbeeld in de tool die je koppelt.

Blok API-sleutel aanmaken met het veld Naam van de token ingevuld met Docs example en de Rechten users:read, users:write, user-products:read en user-products:write aangevinkt; orders:read, products:read, hooks:read en hooks:write zijn niet aangevinkt; knop Toevoegen
Een nieuwe API-sleutel met vier rechten (nog niet aangemaakt)
Venster Kopieer de API-sleutel met de tekst Neem onderstaande API-sleutel over, een voorbeeldsleutel en de waarschuwing Let op! Wordt niet nog een keer vertoond
De sleutel wordt maar één keer getoond

De sleutel wordt maar één keer getoond. Sluit je het venster zonder hem te kopiëren, dan kun je hem niet meer zien: verwijder de sleutel en maak een nieuwe aan. Behandel een sleutel als een wachtwoord: iedereen die hem heeft, kan hem gebruiken met de rechten die je hem gaf.

Rechten

RechtWat de sleutel mag
orders:readBestellingen ophalen.
products:readJe producten ophalen.
users:readLeden ophalen.
users:writeLeden aanmaken en hun gegevens wijzigen.
user-products:readOphalen wie toegang heeft tot welk product.
user-products:writeLeden toegang geven tot een product.
hooks:readDe hooks van producten en funnels ophalen.
hooks:writeHooks van producten en funnels toevoegen, wijzigen en verwijderen (zie Hooks).

Geef een sleutel alleen de rechten die hij echt nodig heeft. Een tool die alleen nieuwe kopers aan een mailinglijst toevoegt, heeft bijvoorbeeld genoeg aan orders:read. De rechten van een bestaande sleutel kun je niet wijzigen; maak dan een nieuwe sleutel aan.

Je sleutels

Lijst API-sleutels met één sleutel: Docs example, Nooit gebruikt, met de rechten users:read, users:write, user-products:read, user-products:write en een prullenbak
De lijst met je sleutels

Onder het formulier zie je je sleutels met hun naam, wanneer ze voor het laatst gebruikt zijn (Laatst gebruikt op een datum en tijd, of Nooit gebruikt) en hun rechten.

  • Sleutels zijn van jou. Je ziet alleen de sleutels die je zelf hebt aangemaakt; andere beheerders zien ze niet en hebben hun eigen sleutels. Een sleutel werkt voor de sites waar je beheerder bent, en werkt niet meer als je beheerderstoegang wordt ingetrokken.
  • Sleutels verlopen niet. Een sleutel blijft werken tot je hem verwijdert.
  • Intrekken: klik op de prullenbak en bevestig. De sleutel werkt direct niet meer; tools die hem nog gebruiken krijgen een foutmelding.

Maak per tool of koppeling een aparte sleutel aan, met een duidelijke naam. Dan kun je één koppeling intrekken zonder de andere te breken, en zie je aan Laatst gebruikt op welke sleutels nog in gebruik zijn.

Lees verder

Op deze pagina