Время чтения: 5 минут
Платформа флота
Мобильное приложение

Создавайте пользовательские интеграции
с использованием Zeo API

Подключите свои системы к Zeo с помощью нашего RESTful API. Создавайте маршруты,
Отслеживайте прогресс в режиме реального времени и автоматизируйте рабочие процессы с помощью веб-хуков.

Zeo API и веб-хуки, Zeo Route Planner
  • 99.9%.

    Соглашение об уровне обслуживания API

  • 100ms

    Среднее время ответа

  • 20+

    Конечные точки API

  • 10K

    Ограничение на количество запросов в минуту

Платформа разработчика Особенности

Всё необходимое для интеграции планирования маршрутов в ваши приложения.

  • Zeo API и веб-хуки, Zeo Route Planner

    REST API

    Полнофункциональный RESTful API для управления маршрутами, остановками, водителями и многим другим. Формат запросов/ответов JSON с подробной документацией.

    • Создавайте и оптимизируйте маршруты программным способом.
    • Управление остановками, водителями и транспортными средствами.
    • Получение данных отслеживания в режиме реального времени.
    • Доступ к аналитике и отчетам
    • Поддержка массовых операций
  • Zeo API и веб-хуки, Zeo Route Planner

    События веб-перехвата

    Уведомления о событиях в режиме реального времени передаются на ваши конечные устройства. Мгновенно реагируйте на изменения маршрута, завершение остановок и обновления данных о водителях.

    • События, начатые/завершенные по маршруту
    • Отключить уведомления об изменении статуса
    • Обновления местоположения водителя
    • Уведомления об изменении расчетного времени прибытия
  • Zeo API и веб-хуки, Zeo Route Planner

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

    Безопасный доступ к API с использованием стандартной отраслевой аутентификации. Несколько типов ключей для разных уровней доступа и сценариев использования.

    • аутентификация с помощью токена Bearer
    • Панель управления ключами API
    • Ограниченные права доступа для каждого ключа
    • Поддержка вращения клавиш
    • Ограничение скорости запросов по каждому ключу
  • Zeo API и веб-хуки, Zeo Route Planner

    Импорт от третьих лиц

    Беспрепятственный импорт заказов и заданий из внешних систем. Автоматическая проверка адресов и геокодирование при импорте.

    • Конечная точка массовой остановки импорта
    • Проверка адресов и геокодирование
    • Пользовательское сопоставление полей
    • Обнаружение дубликатов
    • Отслеживание статуса импорта

webhook Мероприятия

Подпишитесь на события в режиме реального времени и мгновенно реагируйте на изменения маршрута.

  • Кадр 1707478314 20 1, Планировщик маршрутов Zeo

    маршрут.начал

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

  • Рама 1707478314 19, Планировщик маршрутов Zeo

    стоп.завершено

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

  • Рама 1707478314 17, Планировщик маршрутов Zeo

    stop.failed

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

  • Группа 11880, Планировщик маршрутов Zeo

    driver.location_update

    Периодическое обновление местоположения активных водителей. Настраиваемая частота от 30 секунд до 5 минут.

  • Группа 11880 1, Планировщик маршрутов Zeo

    eta.changed

    Срабатывает при значительном изменении расчетного времени прибытия из-за пробок или задержек.

  • Группа 11880 2, Планировщик маршрутов Zeo

    маршрут.завершено

    Запускается после завершения всех остановок. Включает итоговую статистику, продолжительность и показатели производительности.

  • // Пример полезной нагрузки веб-хука
    {
      "событие": "stop.completed",
      "метка времени": "2024-01-15T14:32:00Z",
      "данные": {
        "route_id": "route_abc123",
        "stop_id": "stop_xyz789",
        "водитель": {
          "мне бы": "drv_456",
          "название": "Джон Смит"
        },
        "completed_at": "2024-01-15T14:31:45Z",
        "доказательство": {
          "подпись": "https://...",
          "фотографии"["https://..."],
          "Примечания": "Оставлено у двери"
        } } }

    Конечные точки API Обзор

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

    POST
    /v1/routes

    Создайте новый маршрут с остановками и настройками оптимизации.

    ПОЛУЧИТЬ
    /v1/routes/{id}

    Получите подробную информацию о маршруте, включая оптимизированную последовательность.

    POST
    /v1/routes/{id}/optimize

    Оптимизируйте существующий маршрут с учетом обновленных параметров.

    ПОЛУЧИТЬ
    /v1/routes/{id}/tracking

    Получайте данные отслеживания активного маршрута в режиме реального времени.

    POST
    /v1/stops/import

    Массовый импорт данных из внешних систем прекращается.

    ПОЛОЖИЛ
    /v1/stops/{id}/status

    Обновить статус остановки (завершено, не удалось, пропущено)

    ПОЛУЧИТЬ
    /v1/drivers

    Список всех водителей с указанием статуса доступности.

    ПОЛУЧИТЬ
    /v1/drivers/{id}/location

    Получить текущее местоположение и информацию о ходе выполнения маршрута.

    POST
    /v1/webhooks

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

    Code Примеры

    Начните быстро с примерами на вашем любимом языке.



    # Создание и оптимизация маршрута с несколькими остановками
    завиток -X ПОСТ "https://api.zeoroute.com/v1/routes" -H "Авторизация: Bearer $ZEO_API_KEY" -H «Тип содержимого: application/json» -d '{ "name": "Утренние доставки", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 Warehouse St, City" }, "stops": [ { "address": "456 Customer Ave", "time_window": {"start": "09:00", "end": "12:00"}, "service_time": 15 }, { "address": "789 Business Blvd", "priority": "high", "service_time": 30 } ] }'
    
    # Получить подробную информацию о маршруте
    curl -X ПОЛУЧИТЬ "https://api.zeoroute.com/v1/routes/route_abc123" -H "Авторизация: Bearer $ZEO_API_KEY"
    
    # Обновление статуса остановки
    завиток -X ПОСТАВИТЬ "https://api.zeoroute.com/v1/stops/stop_xyz789/status" -H "Авторизация: Bearer $ZEO_API_KEY" -H «Тип содержимого: application/json» -d '{"status": "completed", "notes": "Left at door"}'

    интеграцию Случаи использования

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

    ДОСТАВКА

    Интеграция управления заказами

    Платформа электронной коммерции автоматически импортирует новые заказы через API каждый час. Заказы группируются по регионам, оптимизируются по маршрутам и отправляются водителям. Веб-хуки обновляют статус заказа в режиме реального времени по мере завершения доставки.

    ОБСЛУЖИВАНИЕ НА МЕСТЕ

    Планирование обслуживания на основе CRM-системы

    Компания, предоставляющая услуги выездного обслуживания, синхронизирует рабочие заказы из своей CRM-системы через API. Новые задания автоматически создают точки обслуживания с указанием данных клиента, требований к услуге и временных интервалов. Веб-хуки по завершении работ обновляют CRM-систему и запускают выставление счетов.

    Группа 1707478361, Планировщик маршрутов Zeo

    Готов к строительству Ваша интеграция?

    Получите свой API-ключ и начните разработку за считанные минуты, используя нашу подробную документацию.

    Группа 1707478363, Планировщик маршрутов Zeo

    Зео Анкета

    Часто
    Задаваемые
    вопросы

    Узнать больше

    Zeo API и веб-хуки

    Каковы ограничения скорости запросов к API?

    Стандартные API-ключи позволяют отправлять 1,000 запросов в минуту. Корпоративные тарифные планы позволяют запрашивать более высокие лимиты — до 10 000 запросов в минуту. В каждый ответ включается заголовок ограничения скорости, позволяющий отслеживать использование.

    Как аутентифицировать запросы к API?

    Для всех запросов к API требуется токен Bearer в заголовке Authorization. Вы можете сгенерировать ключи API в настройках своей учетной записи. Ключи могут быть привязаны к определенным правам доступа (только чтение, запись, администрирование) и IP-адресам.

    У вас есть SDK для разных языков?

    Мы предоставляем официальные SDK для JavaScript/Node.js и Python. SDK, поддерживаемые сообществом, доступны для Ruby, PHP и Go. Все SDK являются открытым исходным кодом и доступны на GitHub.

    Как работают повторные попытки веб-хука?

    Если ваш конечный пункт возвращает ответ, отличный от 2xx, мы повторяем попытку с экспоненциальной задержкой: 1 минута, 5 минут, 30 минут, 2 часа и 24 часа. После 5 неудачных попыток веб-хук помечается как неудачный, и вы получаете уведомление по электронной почте.

    Существует ли изолированная среда для тестирования?

    Да, мы предоставляем полноценную тестовую среду по адресу api-sandbox.zeoroute.com. В тестовой среде используется тот же API, но с тестовыми данными и без каких-либо платежей. Идеально подходит для разработки и интеграционного тестирования.

    Доступен ли API на всех тарифных планах?

    REST API Zeo доступен в тарифных планах Fleet Management и Enterprise. Он включает в себя полное управление маршрутами, организацию остановок, управление водителями и поддержку веб-хуков для уведомлений о событиях в режиме реального времени.

    Почему мне следует использовать API Zeo вместо ручного ввода данных?

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

    Какие проблемы решают веб-хуки для автоматизированных рабочих процессов?

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

    Можно ли создавать собственные автоматизации с помощью API?

    Да. Вы можете интегрировать Zeo с внутренними инструментами, ERP-системами или пользовательскими приложениями, используя полноценный REST API, который поддерживает создание сущностей и получение подробных данных.

    Как данные в реальном времени, передаваемые через веб-хуки, улучшают операционную деятельность?

    Веб-хуки обеспечивают мгновенное обновление информации о ходе выполнения маршрута, изменениях расчетного времени прибытия и местоположении водителя, благодаря чему системы и команды остаются синхронизированными без ручного обновления.

    О каких типах событий могут уведомлять веб-хуки?

    Веб-хуки используются для запуска таких событий, как начало маршрута, завершение остановки, обновление драйверов и другие этапы выполнения маршрута в ваших системах.

    Полезно ли использовать API и веб-хуки для масштабирования операций?

    Безусловно. Они позволяют разработчикам автоматизировать большие объемы маршрутных данных и глубоко интегрировать Zeo в корпоративные рабочие процессы по мере роста бизнеса.

    Zeo Блог

    Посетите наш блог, чтобы найти полезные статьи, советы экспертов и вдохновляющий контент, который будет держать вас в курсе.

    22.04.2026 Как сократить время в пути при продажах фармацевтической продукции. Планировщик маршрутов Zeo.

    Как сократить время в пути для специалистов по продажам фармацевтической продукции на 30-40%

    Время чтения: 6 минутУзнайте о проверенных стратегиях сокращения времени поездок представителей фармацевтических компаний на 30-40% за счет оптимизации маршрутов, что позволит вашим торговым представителям уделять больше времени продажам врачам.

    22.04.2026 Мобильная мойка и чистка автомобилей: проблемы управления автопарком. Планировщик маршрутов Zeo.

    Проблемы управления автопарком мобильных услуг по детейлингу: 7 решений

    Время чтения: 7 минутПреодолейте проблемы управления автопарком мобильной автомойки с помощью проверенных решений для оптимизации маршрутов, координации работы команды и прибыльного масштабирования операций.

    09.02.2026 Как оптимизировать маршруты мобильной мойки и полировки автомобилей. Планировщик маршрутов Zeo.

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

    Время чтения: 7 минутУзнайте, как оптимизировать маршруты мобильной мойки и полировки автомобилей с учетом логистики оборудования, изменений продолжительности обслуживания и погодных условий, чтобы максимизировать ежедневную прибыль…

    Xlork Это платформа для импорта данных, ориентированная на разработчиков. Она позволяет встраивать импорт CSV-файлов, Excel и Google Sheets в любое приложение с помощью искусственного интеллекта. Сопоставление столбцов и проверка схемы. Исследуйте бесплатно Средства для разработчиков например, конвертеры JSON в CSV и генераторы цветовых палитр. Больше не нужно создавать потоки импорта с нуля — просто вставьте необходимые компоненты. Xlork SDK, Бесплатная регистрацияи отправлять чистые данные за считанные минуты.