ПЭК API личного кабинета: POST /cargos/status/ — Статусы грузов

До 15 кодов грузов за запрос.

Статусы cargos[].info.cargoStatus: «Заявка на забор зарегистрирована», «Принят к перевозке», «В пути», «Прибыл», «Выполняется адресная доставка», «Выдан получателю», «Доставлен получателю», «Возвращен отправителю» и др.

Параметр	Где	Тип	Обяз.	Описание
`cargoCodes`	body	array	да	Коды грузов

Пример запроса:

{
   "cargoCodes": [
       "780339690775",
       "999932277461",
       "772193116238"
   ]
}

Базовые URL

Боевой: https://kabinet.pecom.ru/api/v1/
URL метода: https://kabinet.pecom.ru/api/v1/<группа>/<метод>/

Авторизация

Тип: Basic Auth

HTTP Basic-аутентификация: логин — имя пользователя личного кабинета ПЭК, пароль — любой активный ключ доступа API. Ключ создаётся на странице «Регистрационные данные» в разделе «Ключи API»; для разных приложений рекомендуются разные ключи. Анонимный доступ не поддерживается.

Обязательные заголовки: Content-Type: application/json;charset=utf-8, Accept: application/json. Для сжатия ответов — Accept-Encoding: gzip. HTTPS с обязательной проверкой сертификата сервера.

curl.exe ^
--verbose ^
--cacert cacert-kabinet_pecom_ru.pem ^
--basic ^
--user user:FA21831AB83DB72D3261FA80BA309DBF6B2D7ADC ^
--request POST -d @curl-input.txt ^
--header "Content-Type: application/json; charset=utf-8" ^
--compressed ^
--output curl-output.txt ^
https://kabinet.pecom.ru/api/v1/cargos/status/

Нюансы

Все поля JSON-объекта в запросе обязательны, если не указано обратное.
Логические ошибки (нет параметров, неверный формат) приходят с HTTP 200 и объектом error в теле — проверяйте его наличие, а не только статус.
В cargos передавайте каждое грузоместо отдельным элементом; если известны только общие параметры — столько элементов, сколько мест, со средними весом и объёмом.
Числа в габаритах округляются до сотых в большую сторону — передавайте не больше двух знаков после запятой.
Вес — в килограммах, габариты — в метрах.
Признак isHP применяется ко всему грузу, если стоит хотя бы у одного места.
Часть полей /cargos/status/ заполняется только при оформленном доступе к информации участников перевозки.

Сценарии с этим методом

Отследить груз

Если этого недостаточно — официальная документация: https://kabinet.pecom.ru/api/v1 Вся интеграция одним документом: https://mcp-everything.ru/integrations/pek.md