Маршруты

Эндпоинты для получения информации о маршрутах доставки.

Получение списка маршрутов

Получить список всех маршрутов на указанную дату.

Запрос

GET /routes?date={date}&depot_number={depot_number}

Параметры запроса:

• date (string, required) — дата доставки в формате d.m.Y (например, 24.11.2025)
• depot_number (string, optional) — номер склада для фильтрации

Заголовки:

X-API-Key: ваш_api_ключ

Ответ

{
  "ok": true,
  "result": [
    {
      "id": "J8nJ",
      "date": "24.11.2025",
      "status": "in_progress",
      "courier_info": {
        "phone": "+79998887766",
        "full_name": "Иванов Иван Иванович"
      },
      "orders": [
        {
          "number": "1000123",
          "status": "in_progress",
          "queue": 5,
          "delivery_time": null,
          "reason_cancellation": null,
          "message": null
        }
      ]
    }
  ]
}

Описание полей

Маршрут

Поле	Тип	Описание
id	string	Идентификатор маршрута
date	string	Дата задачи в формате d.m.Y
status	string	Статус маршрута
courier_info	object | null	Информация о курьере (null для finished/cancelled/new)
orders	array	Список заказов в маршруте

Заказ в маршруте

Поле	Тип	Описание
number	string	Номер заказа
status	string	Статус заказа
queue	integer | null	Порядок доставки в маршруте
delivery_time	string | null	Время доставки/забора (HH:mm)
reason_cancellation	string | null	Причина отмены
message	string | null	Комментарий к заказу

Статусы маршрута

Статус	Описание
new	Новый маршрут
in_progress	Маршрут в работе
finished	Маршрут завершён
cancelled	Маршрут отменён

Примеры использования

cURL

curl -X GET "https://api.razvezu.pro/integration/v2/routes?date=24.11.2025&depot_number=14" \
  -H "X-API-Key: ваш_api_ключ"

JavaScript

const params = new URLSearchParams({
  date: '24.11.2025',
  depot_number: '14'
});

const response = await fetch(
  `https://api.razvezu.pro/integration/v2/routes?${params}`,
  {
    headers: {
      'X-API-Key': 'ваш_api_ключ'
    }
  }
);

const data = await response.json();
console.log(data.result);

Python

import requests

params = {
    'date': '24.11.2025',
    'depot_number': '14'
}

headers = {
    'X-API-Key': 'ваш_api_ключ'
}

response = requests.get(
    'https://api.razvezu.pro/integration/v2/routes',
    params=params,
    headers=headers
)

data = response.json()
print(data['result'])

Пример ответа с несколькими маршрутами

{
  "ok": true,
  "result": [
    {
      "id": "J8nJ",
      "date": "24.11.2025",
      "status": "in_progress",
      "courier_info": {
        "phone": "+79998887766",
        "full_name": "Иванов Иван Иванович"
      },
      "orders": [
        {
          "number": "1000123",
          "status": "in_progress",
          "queue": 1,
          "delivery_time": null
        },
        {
          "number": "1000124",
          "status": "in_progress",
          "queue": 2,
          "delivery_time": null
        }
      ]
    },
    {
      "id": "K9mK",
      "date": "24.11.2025",
      "status": "finished",
      "courier_info": null,
      "orders": [
        {
          "number": "1000125",
          "status": "finished",
          "queue": 1,
          "delivery_time": "14:35"
        }
      ]
    }
  ]
}

Ошибки

401 Unauthorized

Ошибка аутентификации:

{
  "ok": false,
  "errors": {
    "message": "Неверные данные аутентификации"
  }
}

422 Validation Error

Ошибка валидации параметров:

{
  "ok": false,
  "errors": {
    "date": [
      "Поле 'date' должно быть в формате d.m.Y"
    ]
  }
}

500 Internal Server Error

Внутренняя ошибка сервера:

{
  "ok": false,
  "errors": {
    "message": "Ошибка на стороне сервера, попробуйте позже"
  }
}

---

Использование данных маршрута

Данные о маршрутах полезны для:

• Отслеживания прогресса доставки
• Получения информации о курьере
• Планирования логистики
• Мониторинга выполнения заказов

Совет

Используйте route_id из ответа /orders/status для получения детальной информации о маршруте через этот эндпоинт.