Зарегистрируйтесь на Zonos Verified Account, используя
ссылку регистрации Česká pošta.
Заполните адрес своего бизнеса и установите платежные реквизиты.
Войдите в свой Zonos Dashboard и перейдите в Account → Integrations. Таблица показывает два ключа:
Имя в Dashboard↕
Назначение↕
Использовать для API?↕
Account key
Идентификатор для связи с оператором почты
❌ НЕТ
API key
Ключ аутентификации для вызова Zonos API
✅ ДА — используйте этот
Скопируйте токен из строки API key. Он начинается с credential_live_. Вам потребуется этот ключ для обоих методов интеграции.
Храните ключ API в безопасности. Не коммитьте его в систему контроля версий и не делитесь им публично. Если вы подозреваете, что ключ скомпрометирован, создайте новый на той же странице Account → Integrations.
Инструмент Item Quoter в вашем Zonos Dashboard позволяет вам проверить предполагаемые таможенные пошлины для ваших товаров перед отправкой — полезно для проверки тарифов и планирования заранее без создания Declaration ID.
Выберите метод, который соответствует вашей технической схеме. Оба метода создают Declaration ID, которые вы затем загружаете в систему доставки Česká pošta.
Для технических клиентов и разработчиков, которые вызывают Zonos непосредственно из своей собственной системы.
Endpoint
URL: https://api.zonos.com/graphql
Method: POST
Content-Type: application/json
Аутентификация
Передайте ваш ключ API в заголовке credentialToken:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
Пример API
Войдите в свою учетную запись Česká pošta, чтобы увидеть полный пример API, включая полный запрос и ответ.
После создания Declaration ID
Отправьте Declaration ID в Česká pošta вместе с деталями вашей отправки. Česká pošta связывает Declaration ID с отправкой и возвращает номер отслеживания. Zonos не выдает номера отслеживания.
Обработка ошибок
Ошибка / Симптом↕
Вероятная причина и решение↕
Security requirement failed
Ваш ключ API недействителен или передан в неправильном заголовке. Убедитесь, что вы используете API Key (не Account Key) и что имя заголовка точно credentialToken.
HTTP 401 Unauthorized
Ключ API отсутствует в заголовках запроса. Подтвердите, что credentialToken включен.
errors array in response
Мутация вернула ошибку GraphQL. Проверьте поле message в массиве ошибок для получения подробной информации.
Unexpected response shape
Ответ не включал data.declarationCreate.id. Запишите полное тело ответа и убедитесь, что текст мутации совпадает с примером точно.
Настройка учетной записи
Настройка учетной записи
Создайте свой Verified Account, добавьте способ оплаты и подключите свою интеграцию.
Шаг 1 — Создайте Verified Account
Зарегистрируйтесь на Zonos Verified Account, используя ссылку регистрации Česká pošta. Заполните адрес своего бизнеса и установите платежные реквизиты.
Шаг 2 — Добавьте способ оплаты
Добавьте способ оплаты в свою учетную запись Zonos для финансирования перечисления таможенных пошлин по отправлениям, направляемым в США.
Шаг 3 — Получите ключ API
Войдите в свой Zonos Dashboard и перейдите в Account → Integrations. Таблица показывает два ключа:
Скопируйте токен из строки API key. Он начинается с
credential_live_. Вам потребуется этот ключ для обоих методов интеграции.Храните ключ API в безопасности. Не коммитьте его в систему контроля версий и не делитесь им публично. Если вы подозреваете, что ключ скомпрометирован, создайте новый на той же странице Account → Integrations.
Шаг 4 (опционально) — Оцените затраты на таможенные пошлины с помощью Item Quoter
Инструмент Item Quoter в вашем Zonos Dashboard позволяет вам проверить предполагаемые таможенные пошлины для ваших товаров перед отправкой — полезно для проверки тарифов и планирования заранее без создания Declaration ID.
Методы интеграции
Выберите метод, который соответствует вашей технической схеме. Оба метода создают Declaration ID, которые вы затем загружаете в систему доставки Česká pošta.
Для технических клиентов и разработчиков, которые вызывают Zonos непосредственно из своей собственной системы.
Endpoint
https://api.zonos.com/graphqlapplication/jsonАутентификация
Передайте ваш ключ API в заголовке
credentialToken:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxПример API
Войдите в свою учетную запись Česká pošta, чтобы увидеть полный пример API, включая полный запрос и ответ.
После создания Declaration ID
Отправьте Declaration ID в Česká pošta вместе с деталями вашей отправки. Česká pošta связывает Declaration ID с отправкой и возвращает номер отслеживания. Zonos не выдает номера отслеживания.
Обработка ошибок
credentialToken.credentialTokenвключен.errorsarray in responsemessageв массиве ошибок для получения подробной информации.data.declarationCreate.id. Запишите полное тело ответа и убедитесь, что текст мутации совпадает с примером точно.Была ли эта страница полезной?