Описание API MOIS¶

API MOIS служит для прямого взаимодействия между такси сервисами. Считается, что на предыдущем этапе они получили от POIS ссылки друг друга (MOISUrl) и ключи ProviderApiKey для опознания и подтверждения безопасности, и теперь переходят к непосредственному предложению и взятию заказа.

Для упрощения обозначим эти два такси сервиса: СервисЗ - это сервис, который предлагает заказ, СервисВ - это сервис, который располагает исполнителями (водителями) для заказа.

Важное требование: на уровне Сервиса идентификатор водителя и такси-компании, в которой он работает должны быть уникальными.

Стандартная схема обмена методами при взятии заказа выглядит так (выделенные жирным методы обязательны к вызову):

Если необходимо редактирование заказа до взятия, то СервисЗ посылает последовательно Отмену заказа (CancelOrder), а затем новое Предложение (OfferOrder) с уже измененными данными.

Если необходимо редактирование заказа после взятия, то СервисЗ посылает Редактирование заказа (UpdateOrder).