Глоссарий

Словарь API доставки

Каждый термин, который используют API, консоль и приложение водителя, в одном предложении, со ссылкой туда, где он важен.

АвтоприёмСм. →: Правила водителя (расстояние, размеры, часы, зоны), по которым подходящие предложения принимаются за секунды.
Адресная книгаСм. →: Сохранённые места забора и вручения с контактами, доступные из консоли и API.
Волна диспетчеризацииСм. →: Один раунд предложений водителям на смене рядом с забором; радиус растёт от волны к волне, пока кто-то не примет.
ДоставкаСм. →: Один забронированный заказ от забора до одной или нескольких точек вручения, со статусами, подтверждением и ссылкой отслеживания.
Зона обслуживанияСм. →: Город запуска с центром, радиусом и своим тарифом; check_coverage отклоняет расчёты вне всех зон.
Из города в городСм. →: Доставка в тот же день из города запуска в соседний город запуска на расстоянии до 160 км по дороге, одним выделенным водителем.
Класс размераСм. →: S (конверт или пакет), M (от коробки обуви до рюкзака), L (чемодан) или XL (нужен фургон); влияет на цену и на то, каким водителям предлагается заказ.
Ключ песочницыСм. →: Тестовый ключ, который можно получить на странице цен или в консоли, чтобы пройти весь поток без затрат.
КошелёкСм. →: Предоплаченный баланс, из которого финансируется доставка; пополняйте картой или USDC, все движения видны в консоли.
Крайний срок того же дняСм. →: Доставка из города в город должна прибыть до 21:00 по местному времени; если заказ сделан слишком поздно, груз заберут на следующее утро.
Надбавка за обратный путьСм. →: Часть цены доставки из города в город, покрывающая порожний обратный путь водителя: половина расстояния и времени в пути в одну сторону.
НаценкаСм. →: Множитель в реальном времени, когда спрос превышает предложение рядом; всегда виден в разбивке.
Объявленная стоимостьСм. →: value_cents на предмете: сохраняется вместе с доставкой, чтобы можно было рассмотреть претензию о потере или повреждении.
ОстановкаСм. →: Адрес забора или вручения с контактами; локальная доставка — до 8 точек, из города в город — до 3.
Оценка получателяСм. →: Оценка от 1 до 5, которую получатель ставит на странице отслеживания после передачи; водители видят свой средний балл.
Передача по OTPСм. →: Одноразовый код в метаданных доставки; получатель называет его водителю, без него заказ не закрывается.
Повторяющаяся доставкаСм. →: Шаблон, который бронирует сам себя в выбранные дни и время; управляется в консоли и воркером повторов.
Подпись вебхукаСм. →: HMAC-заголовок на каждом вебхуке для проверки, что событие от RentADriver; тестовые отправки из консоли.
ПодтвердитьСм. →: Ваше принятие подтверждения, которое списывает средства; без вызова доставка подтверждается автоматически через 24 часа.
Подтверждение доставкиСм. →: Фото с геометкой, подпись или одноразовый код при передаче, возвращаемые get_proof_of_delivery.
ПредложениеСм. →: Заказ, предложенный водителю в RentADriver Go с деталями; принимается одним касанием или автоматически по его правилам.
РасчётСм. →: Предложение с ценой и маршрутом, которое возвращает POST /v1/quotes с разбивкой и ETA; бесплатно, без ключа, действует 15 минут.
Резерв и списаниеСм. →: Полная цена резервируется в кошельке при бронировании и списывается при подтверждении; отмена снимает резерв.
СрочностьСм. →: asap, today или scheduled; задаёт окно диспетчеризации и один из множителей цены.
Ссылка отслеживанияСм. →: Публичная страница доставки со статусом, позицией водителя и ETA, с вашим логотипом и цветами.
Тестовый режимСм. →: Тестовые ключи создают доставки is_test с симулированными водителями и без движения кошелька; консоль показывает их под баннером песочницы.
ЭтапСм. →: Зафиксированный шаг доставки, например груз на борту при заборе, который меняет, что ещё можно отменить.
MCP-серверСм. →: rentadriver-mcp — сервер Model Context Protocol, который открывает каждую возможность API как инструменты для агента.
quote_idСм. →: Идентификатор расчёта; передайте его в create_delivery, чтобы забронировать ровно по этой цене.
TurnstileСм. →: Необязательная проверка на человека при регистрации из браузера; агенты, MCP-сервер и curl освобождены.