Cargotime

Аутентификация

API-ключи, ограничения запросов и условия использования

Передавайте действующий API-ключ в query-параметре api_key в URL запроса. Получить ключ можно в личном кабинете.

Базовый URL для запросов: https://tracking.cargotime.ru/v2.

Используя API, вы соглашаетесь с публичной офертой и пользовательским соглашением. По вопросам пишите на info@cargotime.ru.

Ограничения

  • Для GET /v2/tracking и POST /v2/tracking/batch действует ограничение до 8 запросов в минуту на API-ключ для каждого эндпоинта.
  • Для GET /v2/tracking/batch — до 3 запросов в секунду и до 30 в минуту на API-ключ.
  • POST /v2/tracking/batch принимает от 1 до 500 номеров в одном запросе.
  • Для коносаментов (type=bl) и букингов (type=bk) укажите SCAC-код перевозчика из списка поддерживаемых компаний. Автоматическое определение company=AUTO доступно только для контейнеров (type=container).

Проверить остаток доступных отслеживаний и сведения об API-ключе можно через GET /v2/apikey.

Типы номеров

Значение typeНомер для отслеживания
containerНомер контейнера
blНомер коносамента
bkНомер букинга (бронирования перевозки)

Если нужного перевозчика нет в списке, попробуйте company=AUTO для номера контейнера. Некоторые морские линии и железнодорожные операторы используют общий источник данных, поэтому результаты для разных перевозчиков могут совпадать.

Обновлено

На этой странице