Перейти к содержимому

API Hopla

Создавайте заказы, добавляйте посылки и события отслеживания. Все, что показывает страница посылки в Hopla, приходит из этих эндпоинтов.

Базовый адресhttps://hopla.delivery
JSON/v1Bearer

От нуля до страницы отслеживания за три запроса

В примерах используются две переменные оболочки. Задайте их один раз:

shell
API=https://hopla.delivery
KEY=hopla_dev_key
  1. Создайте заказ с товарами и посылками

    Один запрос записывает заказ, его товары и посылки. Если не указать службу доставки, она определится по трек-номеру.

    POST /v1/orders
    curl -X POST "$API/v1/orders" \
      -H "Authorization: Bearer $KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: demo-2001" \
      -d '{
        "orderNumber": "HP-2001",
        "store": { "name": "Atelier Nord" },
        "customer": { "name": "Camille Durand", "email": "camille.durand@example.com" },
        "destination": { "city": "Lyon", "postalCode": "69002", "country": "FR" },
        "items": [
          {
            "ref": "a",
            "title": "Linen overshirt",
            "variant": "Sand / M",
            "quantity": 1,
            "unitPriceCents": 8900,
            "imageUrl": "https://cdn.example/overshirt.jpg"
          }
        ],
        "shipments": [
          {
            "trackingNumber": "6A20001118001",
            "carrier": "la-poste",
            "origin": { "city": "Lille", "country": "FR" },
            "items": [ "a" ],
            "simulate": { "scenario": "domestic_home", "autoStart": true }
          }
        ]
      }'
  2. Добавьте событие

    Отправьте код, место и, если есть, исходное сообщение службы доставки. Статус посылки определяется последним событием.

    POST /v1/shipments/:id/events
    curl -X POST "$API/v1/shipments/6A20001118001/events" \
      -H "Authorization: Bearer $KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "substatus": "out_for_delivery",
        "location": { "place": "LYS" },
        "message": "Votre colis est en cours de livraison.",
        "messageLang": "fr",
        "details": { "window": "14:00-18:00" }
      }'
  3. Откройте страницу

    Страница заказа и страница каждой посылки доступны сразу, на четырех языках. Остается отправить ссылку покупателю.

    Посмотреть страницу демо-заказа/ru/order/HP-1042

Авторизация

Для записи нужен API-ключ в заголовке Authorization. Поиск посылок открыт для всех.

header
Authorization: Bearer hopla_dev_key

Заголовок X-Api-Key тоже принимается. Если ключа нет или он неверный, вернется 401 unauthorized. Чтение заказов и посылок возвращает персональные данные, поэтому для него тоже нужен ключ.

Открытые эндпоинты
Открытые эндпоинтыОписание
GET /v1/track/:refНаходит посылку по трек-номеру или весь заказ по номеру либо идентификатору заказа. Из этого ответа строится каждая страница отслеживания.
POST /v1/track/batchИщет до 40 номеров за один запрос. Для каждого возвращается свой результат — найден он или нет.
POST /v1/detectНаходит номера в произвольном тексте и для каждого перечисляет подходящие службы доставки.
GET /v1/carriersСправочник служб доставки с шаблонами, по которым распознаются номера.
GET /v1/carriers/:slugОдна служба доставки по ее идентификатору.
GET /v1/statusesМодель статусов с названиями и описаниями на одном языке или сразу на четырех.
GET /v1/placesМеста, на которые могут ссылаться события: локализованные названия, координаты и часовые пояса.
GET /healthСостояние сервиса и количество записей.
GET /v1/simulator/scenariosМаршруты, которые умеет проигрывать симулятор.

Модель статусов

Девять статусов для фильтров и цветов, 52 подстатуса для формулировок.

СтатусКодЧто означает
Ожидает отправкиpendingОтправитель зарегистрировал посылку, но служба доставки ее еще не получила.
В путиin_transitПосылка движется к месту назначения.
Передана курьеруout_for_deliveryПосылка у курьера и должна быть доставлена сегодня.
Готова к выдачеavailable_for_pickupПосылка ждет в пункте выдачи или постамате. Возьмите с собой документ или код получения.
ДоставленаdeliveredконечныйПосылка доставлена.
Не удалось вручитьfailed_attemptКурьер пытался доставить посылку, но не смог. Обычно назначается повторная доставка или выдача в пункте.
Проблема с доставкойexceptionЧто-то задерживает посылку. Посмотрите последнее событие, чтобы узнать, что будет дальше.
Возврат отправителюreturnedПосылка возвращается или уже возвращена отправителю.
Нет обновленийexpiredСлужба доставки давно не сообщала ничего нового. Если посылка не пришла, свяжитесь с отправителем.
В магазине · 3 кода
  • order_placedЗаказ оформлен → pending
  • order_processingЗаказ собирается → pending
  • order_readyЗаказ готов к отправке → pending
Прием посылки · 5 кодов
  • info_receivedТрек-номер присвоен → pending
  • awaiting_carrier_pickupОжидает передачи в доставку → pending
  • picked_upПринята службой доставки → in_transit
  • dropped_offСдана в отделение → in_transit
  • accepted_originПринята на складе отправления → in_transit
В пути · 4 кода
  • arrived_hubПрибыла в сортировочный центр → in_transit
  • sortedОтсортирована → in_transit
  • departed_hubПокинула сортировочный центр → in_transit
  • in_transitВ пути → in_transit
Экспорт · 4 кода
  • export_hub_arrivedПрибыла в пункт международного обмена → in_transit
  • export_customsЭкспортное таможенное оформление → in_transit
  • departed_origin_countryПокинула страну отправления → in_transit
  • transit_countryПрибыла в транзитную страну → in_transit
Таможня и ввоз · 7 кодов
  • arrived_destination_countryПрибыла в страну назначения → in_transit
  • customs_processingТаможенное оформление → in_transit
  • customs_clearedВыпущена таможней → in_transit
  • customs_heldЗадержана таможней → exception
  • customs_duties_dueОжидает оплаты пошлины → exception
  • customs_info_requiredТаможне нужны документы → exception
  • handed_to_local_carrierПередана местной службе доставки → in_transit
Доставка получателю · 8 кодов
  • arrived_delivery_depotПрибыла в отделение доставки → in_transit
  • out_for_deliveryПередана курьеру → out_for_delivery
  • delivery_rescheduledДоставка перенесена → in_transit
  • deliveredДоставлена → delivered
  • delivered_mailboxДоставлена в почтовый ящик → delivered
  • delivered_signedВручена под подпись → delivered
  • delivered_third_partyВручена доверенному лицу → delivered
  • delivered_safe_placeОставлена в условленном месте → delivered
Пункты выдачи · 4 кода
  • arrived_pickup_pointПрибыла в пункт выдачи → available_for_pickup
  • pickup_reminderНапоминание о получении → available_for_pickup
  • picked_up_by_recipientПолучена в пункте выдачи → delivered
  • pickup_expiredСрок хранения истек → returned
Попытки вручения · 6 кодов
  • attempt_absentПолучателя не было на месте → failed_attempt
  • attempt_closedАдрес был закрыт → failed_attempt
  • address_issueПроблема с адресом → exception
  • recipient_refusedОтказ получателя → exception
  • recipient_unreachableНе удалось связаться с получателем → exception
  • awaiting_recipient_actionОжидает решения получателя → exception
Проблемы · 9 кодов
  • delayedЗадерживается → exception
  • misroutedОшибка маршрута → exception
  • damagedПовреждена → exception
  • lostУтеряна → exception
  • on_holdНа временном хранении → exception
  • security_checkНа проверке → exception
  • redirectedПеренаправлена → in_transit
  • cancelledОтправка отменена → exception
  • no_updatesНет обновлений → expired
Возвраты · 2 кода
  • return_in_transitВозвращается отправителю → returned
  • return_deliveredВозвращена отправителю → returned
Отправляйте коды, а не фразы: Hopla сам напишет фразу на языке читателя.

Справочник

Любой ответ имеет вид { "data": … }, у списков есть еще meta, а при ошибке приходит { "error": … }. Имена полей — в camelCase, время — в формате ISO 8601 со смещением.

Заказы

POST/v1/ordersAPI-ключ

Создает заказ с товарами и посылками одной транзакцией. Если хотя бы одна часть неверна, не записывается ничего.

ИмяТипОписание
Idempotency-KeyзаголовокstringДелает повтор безопасным: тот же ключ с тем же телом вернет первый ответ.
orderNumberтелообязательноstringВаш собственный номер, от 1 до 40 символов, уникальный.
storeтелообязательноobjectname обязательно; url и supportEmail — по желанию.
customerтелообязательноobjectname обязательно. На открытых страницах имя скрыто.
destinationтелообязательноobjectcity и country обязательны. Улица и дом никогда не показываются на открытых страницах.
itemsтелообязательноItem[]От 1 до 100 товаров: title, quantity и по желанию variant, unitPriceCents, imageUrl. ref связывает товар с посылкой.
shipmentsтелоShipment[]От 0 до 20 посылок. Заказ можно создать до отправки.
localeтелоen | fr | zh | ruЯзык покупателя.
POST /v1/orders
curl -X POST "$API/v1/orders" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-2001" \
  -d '{
    "orderNumber": "HP-2001",
    "store": { "name": "Atelier Nord" },
    "customer": { "name": "Camille Durand", "email": "camille.durand@example.com" },
    "destination": { "city": "Lyon", "postalCode": "69002", "country": "FR" },
    "items": [
      {
        "ref": "a",
        "title": "Linen overshirt",
        "variant": "Sand / M",
        "quantity": 1,
        "unitPriceCents": 8900,
        "imageUrl": "https://cdn.example/overshirt.jpg"
      }
    ],
    "shipments": [
      {
        "trackingNumber": "6A20001118001",
        "carrier": "la-poste",
        "origin": { "city": "Lille", "country": "FR" },
        "items": [ "a" ],
        "simulate": { "scenario": "domestic_home", "autoStart": true }
      }
    ]
  }'

GET/v1/ordersAPI-ключ

Список заказов, сначала новые, с фильтрами и курсорной пагинацией.

ИмяТипОписание
qпараметрstringИщет по номеру заказа, имени или почте покупателя, трек-номеру.
statusпараметрstringОдин или несколько кодов статуса через запятую.
demoпараметр0 | 1Только демо-заказы или только ваши собственные.
expandпараметрshipments | eventsДобавляет события каждой посылки.
limitпараметрintegerРазмер страницы. По умолчанию 20, не более 100.
cursorпараметрstringЗначение meta.nextCursor предыдущей страницы.
GET /v1/orders
curl "$API/v1/orders?status=exception,failed_attempt&limit=10" \
  -H "Authorization: Bearer $KEY"

GET/v1/orders/:refAPI-ключ

Возвращает заказ целиком, включая персональные данные.

ИмяТипОписание
refпутьобязательноstringИдентификатор или номер заказа.
expandпараметрeventsДобавляет события каждой посылки.
GET /v1/orders/:ref
curl "$API/v1/orders/HP-1042?expand=events" \
  -H "Authorization: Bearer $KEY"

PATCH/v1/orders/:refAPI-ключ

Обновляет заказ: этапы сборки, сообщение покупателю, товары. Номер заказа не меняется никогда.

ИмяТипОписание
refпутьобязательноstringИдентификатор или номер заказа.
processingAt · readyAt · cancelledAtтелоISO 8601Когда магазин начал сборку, закончил упаковку или отменил заказ.
noticeтелоstring | nullКороткое сообщение магазина, которое показывается на странице заказа.
itemsтело{ add, update, remove }Товары, которые нужно добавить, изменить или убрать.
PATCH /v1/orders/:ref
curl -X PATCH "$API/v1/orders/HP-2001" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "processingAt": "2026-11-18T11:00:00+01:00",
    "notice": "Packed with care — ships tomorrow."
  }'

DELETE/v1/orders/:refAPI-ключ

Удаляет заказ вместе с посылками, товарами и событиями.

ИмяТипОписание
refпутьобязательноstringИдентификатор или номер заказа.
DELETE /v1/orders/:ref
curl -X DELETE "$API/v1/orders/HP-2001" \
  -H "Authorization: Bearer $KEY"

События

POST/v1/shipments/:id/eventsAPI-ключ

Добавляет одно событие или до 50 в массиве events. События можно присылать в любом порядке: статус всегда берется из самого позднего.

ИмяТипОписание
idпутьобязательноstringИдентификатор посылки или ее трек-номер.
substatusтелообязательноstringЧто произошло — код из модели статусов.
occurredAtтелоISO 8601Когда это произошло, с местным смещением. По умолчанию — сейчас.
locationтело{ place } | { city, country, … }Код места или свободные поля с необязательными координатами.
message · messageLangтелоstringИсходный текст службы доставки и его язык. Возвращается без изменений.
detailsтелоobjectДополнения для некоторых кодов: signedBy, window, deadline, reason.
externalIdтелоstringВаш идентификатор события: отправленное дважды, оно запишется один раз.
POST /v1/shipments/:id/events
curl -X POST "$API/v1/shipments/6A20001118001/events" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "substatus": "out_for_delivery",
    "location": { "place": "LYS" },
    "message": "Votre colis est en cours de livraison.",
    "messageLang": "fr",
    "details": { "window": "14:00-18:00" }
  }'

DELETE/v1/shipments/:id/events/:eventIdAPI-ключ

Удаляет ошибочное событие. Статус пересчитывается.

ИмяТипОписание
idпутьобязательноstringИдентификатор посылки или ее трек-номер.
eventIdпутьобязательноstringСобытие, которое нужно удалить.
DELETE /v1/shipments/:id/events/:eventId
curl -X DELETE "$API/v1/shipments/6A20001118001/events/evt_9t4r6y1n8zc2" \
  -H "Authorization: Bearer $KEY"

Посылки

POST/v1/shipmentsAPI-ключ

Создает посылку отдельно или привязывает ее к существующему заказу. Обязателен только трек-номер.

ИмяТипОписание
Idempotency-KeyзаголовокstringДелает повтор безопасным: тот же ключ с тем же телом вернет первый ответ.
trackingNumberтелообязательноstringХранится заглавными буквами, без пробелов. Уникален.
carrierтелоslugМожно не указывать, если формат номера однозначно определяет службу.
lastMileтело{ trackingNumber, carrier }Служба, которая принимает посылку в стране назначения, и ее номер.
origin · destinationтелоobjectГород и страна либо код места. Место назначения по умолчанию берется из заказа.
deliveryTypeтелоhome | pickup_point | locker | mailboxКуда вручается посылка.
etaтело{ from, to, window, source }Ожидаемая дата доставки: одна дата или диапазон, а также источник прогноза.
orderId · orderNumberтелоstringПривязывает посылку к существующему заказу.
simulateтело{ scenario, autoStart }Привязывает сценарий симулятора; autoStart сразу выполняет первый шаг.
POST /v1/shipments
curl -X POST "$API/v1/shipments" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "trackingNumber": "1Z999AA10123456784",
    "label": "Desk lamp",
    "origin": { "city": "Chicago", "country": "US" },
    "destination": { "city": "Austin", "region": "TX", "country": "US" },
    "simulate": { "scenario": "us_domestic" }
  }'

GET/v1/shipmentsAPI-ключ

Список посылок, сначала новые, с фильтрами и курсорной пагинацией.

ИмяТипОписание
qпараметрstringИщет по трек-номеру, названию или номеру заказа.
status · substatus · carrierпараметрstringФильтр по статусу, подстатусу или службе доставки.
expandпараметрeventsДобавляет события каждой посылки.
limitпараметрintegerРазмер страницы. По умолчанию 20, не более 100.
cursorпараметрstringЗначение meta.nextCursor предыдущей страницы.
GET /v1/shipments
curl "$API/v1/shipments?status=in_transit&carrier=china-post" \
  -H "Authorization: Bearer $KEY"

GET/v1/shipments/:idAPI-ключ

Возвращает посылку со всеми событиями, сначала новые. Вместо идентификатора можно указать трек-номер.

ИмяТипОписание
idпутьобязательноstringИдентификатор посылки или ее трек-номер.
GET /v1/shipments/:id
curl "$API/v1/shipments/6A20001118001" \
  -H "Authorization: Bearer $KEY"

PATCH/v1/shipments/:idAPI-ключ

Меняет ожидаемую дату, службу доставки, последний этап, пункт выдачи или сценарий симулятора. Статус меняется только через события.

ИмяТипОписание
idпутьобязательноstringИдентификатор посылки или ее трек-номер.
etaтелоobject | nullОжидаемая дата доставки: одна дата или диапазон, а также источник прогноза.
carrier · lastMileтелоslug · objectСлужба, которая принимает посылку в стране назначения, и ее номер.
simulateтело{ scenario } | nullПривязывает сценарий симулятора; autoStart сразу выполняет первый шаг.
PATCH /v1/shipments/:id
curl -X PATCH "$API/v1/shipments/6A20001118001" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "eta": { "from": "2026-11-20", "to": "2026-11-21", "source": "carrier" }
  }'

DELETE/v1/shipments/:idAPI-ключ

Удаляет посылку и ее события.

ИмяТипОписание
idпутьобязательноstringИдентификатор посылки или ее трек-номер.
DELETE /v1/shipments/:id
curl -X DELETE "$API/v1/shipments/6A20001118001" \
  -H "Authorization: Bearer $KEY"

Отслеживание (открыто)

GET/v1/track/:refОткрыт

Находит посылку по трек-номеру или весь заказ по номеру либо идентификатору заказа. Из этого ответа строится каждая страница отслеживания.

ИмяТипОписание
refпутьобязательноstringТрек-номер, номер последнего этапа, номер заказа, идентификатор заказа или посылки.
langпараметрen | fr | zh | ruЯзык названий, описаний и географических названий. По умолчанию en.
eventsпараметрall | latestlatest возвращает только последнее событие каждой посылки (для списков).
verifyпараметрstringПочта покупателя или почтовый индекс, если сервер требует подтверждать поиск по заказу.
GET /v1/track/:ref
curl "$API/v1/track/LV202611181CN?lang=fr"
GET /v1/track/LV202611181CN?lang=ru&events=latest

POST/v1/track/batchОткрыт

Ищет до 40 номеров за один запрос. Для каждого возвращается свой результат — найден он или нет.

ИмяТипОписание
refsтелообязательноstring[]От 1 до 40 номеров. Повторы объединяются.
langтелоen | fr | zh | ruЯзык названий, описаний и географических названий. По умолчанию en.
eventsтелоlatest | alllatest возвращает только последнее событие каждой посылки (для списков).
POST /v1/track/batch
curl -X POST "$API/v1/track/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "refs": [ "LV202611181CN", "1ZVAD0DEMO00000001", "HP-1042", "ABC" ],
    "lang": "en"
  }'

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

POST/v1/detectОткрыт

Находит номера в произвольном тексте и для каждого перечисляет подходящие службы доставки.

ИмяТипОписание
inputтелообязательноstringПроизвольный текст, не более 5000 символов.
langтелоen | fr | zh | ruЯзык названий, описаний и географических названий. По умолчанию en.
POST /v1/detect
curl -X POST "$API/v1/detect" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Hi! your parcels: 1ZVAD0DEMO00000001 and rr123456785gb, order HP-1042"
  }'

GET/v1/carriersОткрыт

Справочник служб доставки с шаблонами, по которым распознаются номера.

ИмяТипОписание
qпараметрstringИщет по названию, местному названию или идентификатору.
countryпараметрISO 3166-1 alpha-2Двухбуквенный код страны.
kindпараметрpostal | express | ecommerce | regionalТип службы доставки.
popularпараметр1Только службы, которые показываются первыми.
langпараметрen | fr | zh | ruЯзык названий, описаний и географических названий. По умолчанию en.
GET /v1/carriers
curl "$API/v1/carriers?popular=1&lang=ru"
GET /v1/carriers?popular=1&lang=ru

GET/v1/carriers/:slugОткрыт

Одна служба доставки по ее идентификатору.

ИмяТипОписание
slugпутьобязательноstringИдентификатор службы доставки, например la-poste.
langпараметрen | fr | zh | ruЯзык названий, описаний и географических названий. По умолчанию en.
GET /v1/carriers/:slug
curl "$API/v1/carriers/la-poste"
GET /v1/carriers/la-poste?lang=ru

GET/v1/statusesОткрыт

Модель статусов с названиями и описаниями на одном языке или сразу на четырех.

ИмяТипОписание
langпараметрen | fr | zh | ru | allall возвращает все четыре языка сразу.
GET /v1/statuses
curl "$API/v1/statuses?lang=zh"
GET /v1/statuses?lang=ru

GET/v1/placesОткрыт

Места, на которые могут ссылаться события: локализованные названия, координаты и часовые пояса.

ИмяТипОписание
countryпараметрISO 3166-1 alpha-2Двухбуквенный код страны.
langпараметрen | fr | zh | ruЯзык названий, описаний и географических названий. По умолчанию en.
GET /v1/places
curl "$API/v1/places?lang=en&country=FR"
GET /v1/places?lang=ru&country=FR

GET/healthОткрыт

Состояние сервиса и количество записей.

GET /health
curl "$API/health"
GET /health

Симулятор

GET/v1/simulator/scenariosОткрыт

Маршруты, которые умеет проигрывать симулятор.

GET /v1/simulator/scenarios
curl "$API/v1/simulator/scenarios"
GET /v1/simulator/scenarios

POST/v1/simulator/shipments/:id/advanceAPI-ключ

Добавляет следующие запланированные события смоделированной посылки.

ИмяТипОписание
idпутьобязательноstringИдентификатор посылки или ее трек-номер.
stepsтело1–20Сколько запланированных событий добавить. По умолчанию 1.
toтелоsubstatus | "end"Продвигать посылку, пока не появится этот код, или до конца сценария.
atтелоnow | spacedspaced расставляет события в прошлом с реалистичными интервалами так, чтобы последнее пришлось на текущий момент.
POST /v1/simulator/shipments/:id/advance
curl -X POST "$API/v1/simulator/shipments/6A20001118001/advance" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{ "steps": 1 }'

POST/v1/simulator/resetAPI-ключ

Удаляет демо-заказы и создает их заново со свежими датами. Заказы, которые создали вы, сохраняются.

ИмяТипОписание
allтелоbooleanУдалить и заказы, созданные вручную.
POST /v1/simulator/reset
curl -X POST "$API/v1/simulator/reset" \
  -H "Authorization: Bearer $KEY"

Ошибки

У всех ошибок одна структура: постоянный code, сообщение для разработчика и, когда это полезно, details.

HTTPКодКогда возникает
400bad_requestНекорректный JSON или неверный тип содержимого.
401unauthorizedAPI-ключ не передан или неверен.
403verification_requiredСервер требует подтвердить поиск по заказу, а verify не передан или неверен.
404not_foundТакого идентификатора или номера нет. Для поиска в details описано, на что похож номер.
409order_existsТакой номер заказа уже занят. details.existingId указывает на заказ.
409tracking_existsТакой трек-номер уже зарегистрирован.
409idempotency_conflictТот же ключ идемпотентности пришел с другим телом запроса.
413too_manyБольше 40 номеров, 50 событий или 100 товаров в одном запросе.
422validation_errorТело запроса не прошло проверку. В details перечислены пути и ошибки.
429rate_limitedСлишком много открытых запросов с одного адреса. Подождите время из Retry-After.
500internalВсе остальное. Сообщение общее, причина записана в журнале сервера.
422
{
  "error": {
    "code": "validation_error",
    "message": "Request body is invalid.",
    "details": [ { "path": "items[0].quantity", "message": "Must be an integer ≥ 1" } ]
  }
}

Идемпотентность

  1. При создании заказа или посылки передавайте заголовок Idempotency-Key длиной до 100 символов.
  2. Первый успешный ответ хранится 24 часа и повторяется для того же ключа и тела, с заголовком Idempotent-Replay: true.
  3. Тот же ключ с другим телом возвращает 409 idempotency_conflict.
  4. Даже без заголовка номер заказа уникален: повторная отправка вернет 409 order_exists.
header
Idempotency-Key: demo-2001

Языки

?lang=en|fr|zh|ru меняет названия, описания, названия мест и стран. Исходные сообщения служб доставки возвращаются без изменений.

GET /v1/track/:ref
curl "$API/v1/track/LV202611181CN?lang=fr"
curl "$API/v1/track/LV202611181CN?lang=zh"
curl "$API/v1/track/LV202611181CN?lang=ru"

Демо-данные

Четырнадцать демо-посылок охватывают все статусы. Их перемещает симулятор, поэтому в столбце «Статус» видно, где каждая находится прямо сейчас.

Трек-номерСлужба доставкиМаршрутСтатус
LV 2026 1118 1CNChina PostШэньчжэнь → ЛионВ пути
LP 0042 0000 0000 17CainiaoШэньчжэнь → ЛионОжидает отправки
1ZVA D0DE MO00 0000 01UPSЧикаго → ОстинПередана курьеру
6A10 0000 00011La Poste (Colissimo)Лилль → БордоДоставлена
XW 1234 5678 5FRChronopostПариж → МарсельНе удалось вручить
24680135Mondial RelayНант → ТулузаГотова к выдаче
RV 1042 0001 9CNChina PostИу → КазаньПроблема с доставкой
1500 0420 17СДЭКМосква → НовосибирскВ пути
YT 2611 1800 0000 0042YunExpressИу → ПортлендДоставлена
7700 1111 8888FedExНью-Йорк → ДенверПроблема с доставкой
4810 0020 26DHL ExpressГонконг → ЛондонВозврат отправителю
SF 1000 0000 02026SF ExpressШэньчжэнь → ХанчжоуДоставлена
H00V AD00 0000 0001EvriМанчестер → ЛондонНет обновлений
2500 0000 0020 26DPD FranceПариж → ЛилльОжидает отправки