API для интеграторов
Подключайте CRM и системы мониторинга к Инженер Онлайн: создавайте заявки, покупайте тарифы и отслеживайте статусы напрямую из ваших систем.
Открыть Swagger (интерактивная документация)
Базовый URL
https://engineer-online.ru/api/integrator/v1Авторизация
Два способа:
- JWT —
POST /integrator/v1/auth/login, затем заголовокAuthorization: Bearer <accessToken>(токен 15 мин, обновление через/auth/refresh). - API-ключ — заголовок
X-Api-Key: <ключ>(без срока действия, для серверных интеграций; ключ выдаётся по запросу).
Тестовая интеграция
- Email:
int@local.com - Пароль:
User123!
Для тестов используйте JWT через /auth/login. API-ключ для продакшн-интеграции выдаётся отдельно.
Основные методы
| Метод | Путь | Описание |
|---|---|---|
POST | /integrator/v1/auth/login | Получить JWT |
POST | /integrator/v1/auth/refresh | Обновить access token |
GET | /integrator/v1/tariffs | Каталог тарифов |
GET | /integrator/v1/account | Лимиты и тариф интегратора |
POST | /integrator/v1/tariffs/purchase | Выставить счёт на тариф |
GET | /integrator/v1/tariffs/purchases/:id/status | Статус оплаты |
POST | /integrator/v1/tariffs/purchases/:id/verify | Применить тариф после оплаты |
POST | /integrator/v1/orders | Создать заявку |
GET | /integrator/v1/orders | Список заявок со статусами |
GET | /integrator/v1/orders/:id | Детали заявки |
Статусы заявок
DRAFT → NEW → BIDDING → ACCEPTED → IN_PROGRESS → COMPLETED → DONE | CANCELLED
Новые заявки через API создаются в статусе BIDDING. Лимит тарифа списывается при принятии ставки инженера.