Что умеет API
Цена, заказ и статусы — в вашей системе
Покупатель видит стоимость доставки ещё в корзине, а операторам не нужно переносить заказы в кабинет Govza.
Цена заранее
-
Стоимость по координатам
POST /quotes считает цену по точкам забора и доставки с учётом размера груза. Полный адрес не нужен — цену можно показать в корзине.
-
Тариф целиком
GET /pricing отдаёт таблицу цен вашего города, GET /cargo-sizes — надбавки за размер груза.
Доступность
-
Можно ли доставить сейчас
POST /availability отвечает, входят ли адреса в зону доставки и есть ли рядом свободные курьеры, с примерным временем подачи.
-
Ничего не резервирует
Вызывайте при оформлении, чтобы решить, предлагать ли доставку Govza.
Заказы
-
Несколько адресов
Один курьер, много точек доставки. Порядок объезда можно отдать нам — выстроим кратчайший.
-
Правки и отмена
Пока курьер не забрал заказ, его можно изменить целиком или по полям. Отменить — одним запросом.
Статусы
-
Webhook на каждый шаг
Курьер назначен, в пути, доставлено, отменено — с именем и телефоном курьера и причиной отмены. Запросы подписаны.
-
Ссылка для получателя
В ответе на создание заказа — ссылка отслеживания: получатель видит курьера на карте без приложения.
Подключение
От ключа до первой доставки
-
1
Создайте ключ
В кабинете run.govza.app: «API-ключи» → «Создать ключ». Ключ показывается один раз — сохраните его сразу.
-
2
Проверьте его
GET /ping покажет аккаунт, от имени которого работает ключ, и лимит запросов.
-
3
Создайте доставку
Узнайте цену через POST /quotes, затем передайте заказ с адресами и контактами в POST /orders.
-
4
Подключите webhook
Укажите у ключа адрес для уведомлений — статусы будут приходить сами, без опроса.
Работаете в iiko? Есть готовая интеграция без программирования.
Вопросы
Частые вопросы
Кто может получить ключ?
Любой заказчик с аккаунтом в кабинете Govza: ключ создаётся сразу, в разделе «API-ключи». Заказы по ключу создаются от вашего имени, считаются по вашим условиям и видны в вашем списке заказов.
Нужно ли передавать координаты?
Да. Govza не ищет адрес по тексту: в заказе адрес передаётся по полям и с координатами. Для расчёта цены достаточно одних координат.
Можно ли изменить заказ после создания?
Да, пока курьер его не забрал: PUT заменяет заказ целиком, PATCH — только переданные поля. Если поменялись координаты, маршрут рассчитается заново.
Как получатель узнает, где курьер?
По ссылке отслеживания из ответа на создание заказа. Отправьте её получателю — он увидит курьера на карте без приложения.
Есть ли лимит запросов?
Да, у каждого ключа свой лимит в минуту; его значение возвращает GET /ping. На ответ 429 повторите запрос позже, каждый раз увеличивая паузу.
Мы работаем в iiko. Нужен ли нам API?
Нет: для iiko есть готовая интеграция. Достаточно назначить на заказ курьера «Govza» — программировать ничего не нужно.
Начните с документации
Быстрый старт проведёт от ключа до первой доставки, а справочник описывает каждый метод и поле.