Skip to main content
In API-instellingen maak je API-tokens aan. Met een API-token kunnen je eigen systemen, of een ontwikkelaar die voor je werkt, rechtstreeks met Zippendo praten: zendingen aanmaken, bestellingen lezen, of een magazijn- of backofficesysteem koppelen.

​
Waar vind je het

Open het organisatiemenu onderaan de zijbalk, klik op Beheren en dan op het tabblad API-instellingen. Je ziet je tokens en een knop API-token toevoegen. Elk abonnement bevat API-tokens: Free tot 2, Standard 5, Growth 10, Pro en Enterprise onbeperkt.

​
Een API-token aanmaken

1

Open het venster

Klik op API-token toevoegen (of op Eerste token aanmaken als de lijst leeg is).
2

Geef het token een naam

Vul een Tokennaam * in, zoals “WMS-integratie” of “Backoffice”, zodat je het later herkent. Je kunt ook Verloopt over (dagen) instellen (maximaal 365) en, als je organisatie merken heeft, Beperken tot merk.
3

Kies de rechten

Vink de Rechten * aan die het token nodig heeft, bijvoorbeeld Zendingen bekijken en Zendingen bewerken.
4

Maak het token aan en kopieer het

Klik op Token aanmaken. Het volledige token wordt één keer getoond, in API-token aangemaakt. Klik op Kopiëren en bewaar het op een veilige plek: je kunt het niet meer zien nadat je het venster sluit.
Behandel een API-token als een wachtwoord. Deel het niet en zet het niet in code die anderen kunnen zien. Als een token uitlekt, verwijder je het en maak je een nieuw token aan.

​
Het token gebruiken

Je ontwikkelaar stuurt het token mee in de Authorization-header van elk verzoek: Authorization: Bearer YOUR_TOKEN Het adres dat moet worden aangeroepen en alle verzoeken staan in de API-referentie. Een token heeft alleen toegang tot de gegevens van je eigen organisatie.

​
Een token beperken tot een merk

Als je organisatie merken gebruikt, kun je Beperken tot merk instellen wanneer je een token aanmaakt. Elk verzoek met dat token kan dan alleen de gegevens van dat merk lezen en schrijven. Je kunt het merk later niet wijzigen of verwijderen, dus maak een nieuw token aan als je een ander nodig hebt. Een token zonder merk werkt voor de hele organisatie. Een ontwikkelaar kan een enkel verzoek nog steeds op één merk richten met de X-Zippendo-Brand-header, en een standaard voor lijstverzoeken instellen met de X-Zippendo-Brand-Scope-header (own, shared of both). Zie Merken en de API-referentie.

​
Een token verwijderen

Om te voorkomen dat een token nog werkt, bijvoorbeeld wanneer een integratie wordt stopgezet of het token is blootgelegd, klik je op Verwijderen in de rij van het token in API-instellingen. Typ de naam van het token in hoofdletters en bevestig. Elk systeem dat het token gebruikt stopt direct met werken. Maak een nieuw token aan als het moet blijven draaien. Elk veld in detail: Een API-token aanmaken.