Skip to main content
Met een API-token kan je eigen systeem of het script van een ontwikkelaar met Zippendo werken. Je maakt tokens aan onder Instellingen → API-instellingen (open het organisatiemenu en klik op Beheren). Als een aanroep wordt geweigerd, zegt het antwoord waarom.

​
Wat je ziet

  • 401 Unauthorized met Invalid or expired token of Authentication required.
  • 403 Forbidden met Missing required scope of Je hebt geen toegang tot deze organisatie.
  • 429 Too Many Requests met API rate limit of … requests per minute reached.
  • De aanroep werkt in de Zippendo-app, maar mislukt vanuit je script of server.

​
401: het token wordt niet geaccepteerd

Stuur het token zo mee, met het woord Bearer en één spatie ervoor:
Controleer of:
  1. Het token met zipp_ begint en volledig is gekopieerd, zonder spaties of regeleinden aan het eind.
  2. Het token nog bestaat onder API-instellingen. Een token verwijderen stopt het direct.
  3. Het token niet is verlopen. De kolom Verloopt toont de datum. Een token dat zonder Verloopt over (dagen) is aangemaakt, verloopt nooit.
Zippendo toont een token maar één keer, in API-token aangemaakt. Als je het niet meer hebt, maak je met API-token toevoegen een nieuw token aan en verwijder je het oude. Zie Een API-token aanmaken.

​
403: het token mag dit niet doen

​
429: te veel aanroepen

Elk abonnement staat een aantal API-aanroepen per minuut toe: Als je erboven komt, is het antwoord API rate limit of … requests per minute reached. Please retry in … s. De header Retry-After zegt hoeveel seconden je moet wachten. Wacht zo lang, probeer het dan opnieuw en spreid je aanroepen. Meer: Limieten.

​
Je kunt geen nieuw token aanmaken

Je hebt de limiet van je abonnement bereikt. Upgrade je abonnement of verwijder iets wat je niet meer gebruikt. betekent dat het aantal API-tokens van je abonnement op is: 2 bij Free, 5 bij Standard, 10 bij Growth, en geen limiet bij Pro en Enterprise. Verwijder een token dat je niet meer gebruikt, of upgrade.

​
Goede gewoonten

  • Bewaar tokens op je server. Zet een token nooit op een webshoppagina of in andere code die in de browser van een klant draait.
  • Geef elk systeem een eigen token, met alleen de rechten die het nodig heeft. Dan kun je er een verwijderen zonder de andere te stoppen.
Gerelateerd: REST API-quickstart, API-instellingen, API-overzicht.