Skip to main content
Token API pozwala Twojemu własnemu systemowi lub skryptowi programisty pracować z Zippendo. Tokeny tworzysz w Ustawienia → Ustawienia API (otwórz menu organizacji i kliknij Zarządzaj). Jeśli wywołanie zostanie odrzucone, odpowiedź podaje powód.

​
Co widzisz

  • 401 Unauthorized z Invalid or expired token lub Authentication required.
  • 403 Forbidden z Missing required scope lub Nie masz dostępu do tej organizacji.
  • 429 Too Many Requests z API rate limit of … requests per minute reached.
  • Wywołanie działa w aplikacji Zippendo, ale nie działa z Twojego skryptu lub serwera.

​
401: token nie jest akceptowany

Wyślij token w ten sposób, ze słowem Bearer i jedną spacją przed nim:
Sprawdź, czy:
  1. Token zaczyna się od zipp_ i został skopiowany w całości, bez spacji i podziałów wiersza na końcu.
  2. Token nadal istnieje w sekcji Ustawienia API. Usunięcie tokena zatrzymuje go natychmiast.
  3. Token nie wygasł. Kolumna Wygasa pokazuje datę. Token utworzony bez Wygasa za (dni) nigdy nie wygasa.
Zippendo pokazuje token tylko raz, w oknie Utworzono token API. Jeśli już go nie masz, utwórz nowy token przyciskiem Dodaj token API i usuń stary. Zobacz Utwórz token API.

​
403: token nie ma zezwolenia na to

​
429: zbyt wiele wywołań

Każdy plan dopuszcza określoną liczbę wywołań API na minutę: Po przekroczeniu limitu odpowiedź brzmi API rate limit of … requests per minute reached. Please retry in … s. Nagłówek Retry-After podaje, ile sekund czekać. Poczekaj tyle, spróbuj ponownie i rozłóż wywołania w czasie. Więcej: Limity żądań.

​
Nie możesz utworzyć kolejnego tokena

Osiągnięto limit Twojego planu. Zmień plan albo usuń coś, czego już nie używasz. oznacza, że wykorzystano liczbę tokenów API w Twoim planie: 2 w planie Free, 5 w planie Standard, 10 w planie Growth i bez limitu w planach Pro i Enterprise. Usuń token, którego już nie używasz, albo zmień plan.

​
Dobre nawyki

  • Trzymaj tokeny na swoim serwerze. Nigdy nie umieszczaj tokena na stronie sklepu internetowego ani w innym kodzie uruchamianym w przeglądarce klienta.
  • Daj każdemu systemowi własny token, tylko z potrzebnymi uprawnieniami. Wtedy możesz usunąć jeden, nie zatrzymując pozostałych.
Powiązane: Szybki start z REST API, Ustawienia API, Przegląd API.