Обзор

Получите API-ключСкопировать ссылку на раздел

Создайте ключ в личном кабинете и передавайте его в query-параметре api_key в URL запроса. Для знакомства с API доступен бесплатный тестовый период, который можно оформить в личном кабинете. Для дальнейшей работы оформите платный тариф.

Отправьте запрос на отслеживаниеСкопировать ссылку на раздел

Передайте номер контейнера в GET /v2/tracking. Значение company=AUTO позволяет определить перевозчика автоматически и поддерживается только для type=container.

GET https://tracking.cargotime.ru/v2/tracking?api_key=YOUR_TOKEN&company=AUTO&value=MSDU8368827&type=container
Accept: application/json

Обработайте результатСкопировать ссылку на раздел

Проверьте HTTP-статус, затем поля success и status в ответе. При status: "OK" данные отслеживания находятся в data. Статус INFO_NOT_FOUND означает, что запрос обработан, но данных по указанному номеру нет. Остальные статусы и рекомендации приведены в разделе «Ошибки».

Запрос по одному номеру возвращает результат сразу в ответе. Для нескольких номеров создайте задачу через POST /v2/tracking/batch, а затем получите её результаты через GET /v2/tracking/batch. Подробнее — в примере пакетного отслеживания.

Продолжайте работуСкопировать ссылку на раздел

Используйте примеры запросов, изучите аутентификацию и ограничения или подключите вебхуки, чтобы получать уведомления об изменениях в перевозках. Все операции и поля описаны в справочнике API. Спецификацию можно скачать в формате OpenAPI.