Быстрый старт
Базовый адрес:
https://api.example.com/api/public/v1/
Минимальный цикл интеграции состоит из четырёх шагов:
| Шаг | Запрос | Что происходит |
|---|---|---|
| 1. Выгрузка заказов | POST /orders/bulk/ | до 500 заказов за раз |
| 2. Ожидание координат | GET /orders/{id}/ | геокодирование асинхронное |
| 3. Запуск планирования | POST /planning/jobs/ | расчёт маршрутов |
| 4. Получение результата | GET /planning/jobs/{job_id}/ | или вебхук planning_job.finished |
Проверка связи:
curl -i https://api.example.com/api/public/v1/orders/ \
-H "Authorization: Api-Key ВАШ_КЛЮЧ"
Ответ 200 — ключ рабочий. Ответ 401 — см. раздел 3.
Интеграция только сервер-сервер. Для домена
api.example.comне настроен CORS, поэтому вызывать API напрямую из браузерного JavaScript нельзя. Ключ в любом случае нельзя размещать в клиентском коде — он даёт полный доступ к данным вашей компании.