Создание задачи пакетного отслеживания
Скачать OpenAPIСоздаёт задачу для отслеживания от 1 до 500 номеров. Обработка выполняется асинхронно. API возвращает task_id, не дожидаясь результатов отслеживания. Через некоторое время передайте его в GET /v2/tracking/batch, чтобы получить состояние и результаты. Данные задачи хранятся в кэше до 6 часов.
Авторизация
api_key Передаётся в: query
Параметры запроса
Нужен ли маршрут перевозки
falseТело запроса
application/json
Типы TypeScript
Используйте тип request body в TypeScript.
Тело ответа
application/json
curl -X POST "https://example.com/v2/tracking/batch?need_route=false" \ -H "Content-Type: application/json" \ -d '{ "tracked_items": [ { "company": "COSU", "track_number": { "value": "CSNU6184414", "type": "container" } }, { "company": "AKKU", "track_number": { "value": "AKKNEM25072638", "type": "bl" } } ] }'{ "success": true, "data": { "task_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" }, "status": "OK"}Список поддерживаемых перевозчиков GET
Возвращает поддерживаемых перевозчиков, их SCAC-коды и типы отслеживания. В поле `data` ключ — название компании, значение — объект с полями `scac`, `cn`, `bl`, `bk`. Передавайте `scac` в параметре `company`. Флаги со значением `true` обозначают поддержку контейнеров, коносаментов и букингов соответственно.
Статус и результаты пакетного отслеживания GET
Возвращает состояние задачи из `POST /v2/tracking/batch`. В `data.status`: `CREATED` — ожидает обработки, `HANDLING` — выполняется, `PROCESSED` — завершена. После завершения получите `data.results` и прекратите запросы состояния этой задачи. Для последующих изменений перевозки используйте запросы на отслеживание или вебхуки. Данные задачи хранятся в кэше до 6 часов.