Zaloguj się na swój Zonos Dashboard i przejdź do Konto →
Integracje. Tabela pokazuje dwa klucze:
Nazwa w Dashboard↕
Cel↕
Użyć do API?↕
Klucz konta
Identyfikator do połączenia z operatorem pocztowym
❌ NIE
Klucz API
Klucz uwierzytelniania dla API Zonos
✅ TAK — użyj tego
Skopiuj token z wiersza Klucz API. Zaczyna się od credential_live_. Ten klucz będzie potrzebny
dla obu metod integracji.
Chroń swój klucz API. Nie zatwierdzaj go w kontroli wersji i nie udostępniaj publicznie. Jeśli
uważasz, że został skompromitowany, wygeneruj go ponownie ze strony Konto → Integracje.
Narzędzie Item Quoter w Twoim
Zonos Dashboard pozwala sprawdzić szacunkowe koszty cła dla Twoich produktów przed wysyłką — przydatne
do sprawdzania stawek i planowania bez generowania identyfikatora deklaracji.
Wybierz metodę, która pasuje do Twojej konfiguracji technicznej. Obie metody generują identyfikatory deklaracji, które
następnie przesyłasz do systemu wysyłkowego Česká pošta.
Dla klientów technicznych i programistów, którzy wywoływają Zonos bezpośrednio z własnego systemu.
Punkt końcowy
URL: https://api.zonos.com/graphql
Metoda: POST
Content-Type: application/json
Uwierzytelnianie
Przekaż swój klucz API w nagłówku credentialToken:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
Przykład API
Zaloguj się na swoje konto Česká pošta, aby uzyskać pełny przykład API, w tym kompletne żądanie i
odpowiedź.
Po wygenerowaniu identyfikatorów deklaracji
Wyślij identyfikator deklaracji do Česká pošta wraz ze szczegółami wysyłki. Česká pošta łączy
identyfikator deklaracji z wysyłką i zwraca numer śledzenia. Zonos nie wydaje numerów śledzenia.
Obsługa błędów
Błąd / Objaw↕
Prawdopodobna przyczyna i rozwiązanie↕
Security requirement failed
Twój klucz API jest nieprawidłowy lub został przekazany w nieprawidłowym nagłówku. Upewnij się, że używasz klucza API (nie klucza konta) i nazwa nagłówka to dokładnie credentialToken.
HTTP 401 Unauthorized
Klucz API brakuje w nagłówkach żądania. Potwierdź, że credentialToken jest zawarty.
Tablica errors w odpowiedzi
Mutacja zwróciła błąd GraphQL. Sprawdź pole message w tablicy błędów, aby uzyskać szczegóły.
Nieoczekiwany kształt odpowiedzi
Odpowiedź nie zawierała data.declarationCreate.id. Zarejestruj całą zawartość odpowiedzi i sprawdź, czy tekst mutacji dokładnie odpowiada przykładowi.
Konfiguracja konta
Konfiguracja konta
Utwórz swoje konto Verified Account, dodaj metodę płatności i połącz swoją integrację.
Krok 1 — Utwórz swoje konto Verified Account
Zarejestruj się na konto Zonos Verified Account, używając linku rejestracyjnego Česká pošta. Uzupełnij adres swojej firmy i skonfiguruj rozliczenia.
Krok 2 — Dodaj metodę płatności
Dodaj metodę płatności do swojego konta Zonos, aby sfinansować zwrót cła dla przesyłek kierowanych do USA.
Krok 3 — Uzyskaj swój klucz API
Zaloguj się na swój Zonos Dashboard i przejdź do Konto → Integracje. Tabela pokazuje dwa klucze:
Skopiuj token z wiersza Klucz API. Zaczyna się od
credential_live_. Ten klucz będzie potrzebny dla obu metod integracji.Chroń swój klucz API. Nie zatwierdzaj go w kontroli wersji i nie udostępniaj publicznie. Jeśli uważasz, że został skompromitowany, wygeneruj go ponownie ze strony Konto → Integracje.
Krok 4 (opcjonalnie) — Oszacuj koszty cła za pomocą Item Quoter
Narzędzie Item Quoter w Twoim Zonos Dashboard pozwala sprawdzić szacunkowe koszty cła dla Twoich produktów przed wysyłką — przydatne do sprawdzania stawek i planowania bez generowania identyfikatora deklaracji.
Metody integracji
Wybierz metodę, która pasuje do Twojej konfiguracji technicznej. Obie metody generują identyfikatory deklaracji, które następnie przesyłasz do systemu wysyłkowego Česká pošta.
Dla klientów technicznych i programistów, którzy wywoływają Zonos bezpośrednio z własnego systemu.
Punkt końcowy
https://api.zonos.com/graphqlapplication/jsonUwierzytelnianie
Przekaż swój klucz API w nagłówku
credentialToken:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxPrzykład API
Zaloguj się na swoje konto Česká pošta, aby uzyskać pełny przykład API, w tym kompletne żądanie i odpowiedź.
Po wygenerowaniu identyfikatorów deklaracji
Wyślij identyfikator deklaracji do Česká pošta wraz ze szczegółami wysyłki. Česká pošta łączy identyfikator deklaracji z wysyłką i zwraca numer śledzenia. Zonos nie wydaje numerów śledzenia.
Obsługa błędów
credentialToken.credentialTokenjest zawarty.errorsw odpowiedzimessagew tablicy błędów, aby uzyskać szczegóły.data.declarationCreate.id. Zarejestruj całą zawartość odpowiedzi i sprawdź, czy tekst mutacji dokładnie odpowiada przykładowi.Was this page helpful?