Klucz API to dane identyfikacyjne, którymi Twoja aplikacja loguje się do API Quandy. Utworzysz go w Quandzie w Ustawieniach / Klucze API przyciskiem Utwórz nowy klucz API i wysyłasz go w nagłówku każdego żądania. Aktualna dokumentacja API jest w wersji 1.

Jak utworzyć klucz API

  1. W Quandzie kliknij trzy kropki / Ustawienia / Klucze API.
  2. Kliknij zielony przycisk Utwórz nowy klucz API.
  3. W polu Opis klucza API wpisz nazwę, po której rozpoznasz klucz, na przykład Raynet CRM albo sklep internetowy.
  4. Kliknij Zapisz. Klucz pojawi się na liście, z której go skopiujesz.
Strona Klucze API w Quandzie z listą kluczy, kolumnami Utworzono, Klucz API i Opis klucza API oraz zielonym przyciskiem Utwórz nowy klucz API.
Klucze API w Quandzie.

W ostatniej kolumnie klucz zmienisz albo usuniesz. Chroń klucz API jak hasło i dla każdej aplikacji utwórz osobny.

Jak użyć klucza API w żądaniu

Klucz wysyłasz w nagłówku authorization w postaci Token, a po spacji Twój klucz. Adres bazowy API to https://api.onquanda.com/api/. Połączenie sprawdzisz wywołaniem ping:

GET https://api.onquanda.com/api/helper/ping/
content-type: application/json
authorization: Token TWOJ_KLUCZ_API

Przez API Quanda zachowuje się tak, jakby był zalogowany administrator Twojego konta. Dostęp jest ograniczony uprawnieniami i planem konta.

Jakie ograniczenia ma API

  • Z jednym kluczem API wysyłaj żądania po kolei, nie równolegle.
  • Między końcem jednego a początkiem kolejnego żądania jest przerwa 30 ms.
  • Przy zbyt częstym dostępie API zwróci kod 429 Too many requests i żądanie trzeba powtórzyć.
  • Niektóre wywołania są ograniczone ilością danych wejściowych.

Gdzie znajdziesz dokumentację API

Dokumentacja API w języku angielskim jest na stronie Dokumentacja API, link znajdziesz też w stopce strony. W wersji 1 opisuje kontakty, etykiety, import masowy, kampanie e-mailowe, e-maile transakcyjne, odbiorców, ankiety, użytkowników i webhooki. Jakie są gotowe połączenia bez programowania, na przykład z Raynet CRM, znajdziesz w artykule Połączenie Quandy ze stroną, CRM albo innym oprogramowaniem.

Jeśli sobie nie radzisz albo masz pytanie, śmiało skontaktuj się z naszym wsparciem klienta pod adresem support@onquanda.com albo telefonicznie pod numerem +48 886 080 501.

Najczęstsze pytania

Kliknij trzy kropki, Ustawienia, Klucze API i zielony przycisk Utwórz nowy klucz API. Nazwij klucz, na przykład według aplikacji, która będzie go używać, i zapisz.

Klucz wysyłasz w nagłówku authorization w postaci Token, a po spacji Twój klucz, razem z nagłówkiem content-type application/json. Adres bazowy API to https://api.onquanda.com/api/.

Przez API Quanda zachowuje się tak, jakby był zalogowany administrator konta. Dostęp jest ograniczony uprawnieniami i planem Twojego konta.

Z jednym kluczem API wysyłaj żądania po kolei, nie równolegle. Między końcem jednego a początkiem kolejnego żądania jest przerwa 30 ms. Przy zbyt częstym dostępie API zwróci kod 429 Too many requests i żądanie trzeba powtórzyć.

Tak. Dla każdej aplikacji możesz utworzyć i nazwać osobny klucz. Na liście kluczy API zmienisz albo usuniesz klucz, gdy aplikacja już go nie potrzebuje.