Waypoint
API доставки, через которое интернет-магазины создают отправления, отслеживают курьеров в реальном времени и получают вебхуки о статусе.
Это концепт-проект: реалистичная задача, которую я спланировал и спроектировал, чтобы показать, как я работаю. Он не описывает прошлого клиента и не заявляет клиентских результатов.
Задача
Курьерская компания принимает заказы от магазинов по телефону и через таблицы. Задача: публичный API и кабинет партнёра, чтобы магазины создавали отправления из своих систем, а покупатели видели курьера на карте.
Подход
- 01Сначала спроектирован контракт API в OpenAPI, из него сгенерированы клиентские SDK.
- 02Ключи идемпотентности на каждой записи, чтобы повторные запросы партнёров никогда не создавали дубли отправлений.
- 03Доставка вебхуков через очередь с повторами, подписями и журналом, доступным партнёрам.
Ключевые возможности
- REST API с готовыми SDK
- Карта курьера в реальном времени
- Подписанные вебхуки с повторами
- Кабинет партнёра и API-ключи
- Зоны доставки и правила тарифов
- Песочница для тестов