Главная → Документация → Мониторинг по API
Мониторинг по API
Мониторинг сам перепроверяет машины по расписанию и сообщает, когда что-то изменилось: появился залог, ограничение, новый владелец, истекает полис. Список мониторинга с проверками и частотой вы заводите в личном кабинете, а метод /monitoring позволяет вашей системе добавлять и убирать машины и забирать изменения.
Как это устроено
- Список создаётся в личном кабинете, раздел «Мониторинг»: название, проверки и их частота, лимит расхода в месяц, куда сообщать об изменениях.
- Машины добавляются в список в кабинете или по API. Первая проверка новой машины запоминает её состояние, следующие сравнивают с ним.
- Изменения приходят событием вебхука
monitor.changeсразу, а также доступны запросом по API.
Списки
curl "https://api.avtovincod.ru/monitoring" \ -H "Authorization: Bearer ВАШ_ТОКЕН"
{
"success": 1,
"lists": [
{
"id": 57, "name": "Автопарк", "status": "active", "cars": 124,
"checks": [
{"code": "pledge", "name": "Залоги", "frequency": "week", "frequency_text": "раз в неделю"},
{"code": "score", "name": "Ограничения и розыск", "frequency": "day", "frequency_text": "каждый день"}
],
"month_limit": 30000, "month_spent": 8420.5,
"last_run_at": "2026-11-11T03:12:40+03:00", "created_at": "2026-09-02T11:05:13+03:00"
}
],
"limits": {"cars_used": 124, "cars_max": 500, "cars_left": 376}
}
Суммы в примере условные. id списка нужен во всех остальных запросах. status: active или paused (причина в pause_reason). limits: сколько машин аккаунт может держать на мониторинге во всех списках.
Добавить машины
curl -X POST "https://api.avtovincod.ru/monitoring?id=57" \
-H "Authorization: Bearer ВАШ_ТОКЕН" \
-H "Content-Type: application/json" \
-d '{"items": ["XTA210990Y1234567", {"plate": "А123ВС777", "label": "Газель 5"}]}'
items: как в пакетной проверке. Каждая машина задаётся строкой с номером либо объектом с полями vin, plate, body, sts, label.
{
"success": 1, "added": 2, "duplicates": 0, "over_limit": 0, "errors": [],
"cars": [
{"id": 9051, "label": "", "input": {"vin": "XTA210990Y1234567"}, "added_at": "2026-11-11T15:40:02+03:00"},
{"id": 9052, "label": "Газель 5", "input": {"plate": "А123ВС777"}, "added_at": "2026-11-11T15:40:02+03:00"}
],
"list": {"id": 57, "name": "Автопарк", "status": "active", "cars": 126},
"limits": {"cars_used": 126, "cars_max": 500, "cars_left": 374}
}
- Ответ
201, если добавлена хотя бы одна машина, и200, если все уже были в списке. duplicates: машины, которые уже есть в списке, и повторы в запросе. Повторно они не добавляются.over_limit: машины, которые не поместились в лимит аккаунта.errors: строки с нераспознанным номером.cars[].id: номер машины в списке. По нему или по VIN машину можно убрать.list: состояние списка после добавления, те же поля, что в ответеGET /monitoring(в примере сокращено).
Убрать машину
POST /monitoring?id=57&remove=XTA210990Y1234567
В remove передайте номер машины в списке (cars[].id), VIN или госномер. Машина перестаёт проверяться, ещё не начатые проверки отменяются.
Машины списка и их состояние
GET /monitoring?id=57&cars=1&page=1&per_page=100
{
"success": 1,
"page": {"page": 1, "per_page": 100, "total": 126, "pages": 2},
"cars": [
{
"id": 9051, "label": "", "input": {"vin": "XTA210990Y1234567"},
"found": {"plate": "В456ОР77", "car": "LADA 2109, 2000"},
"checks": [
{"code": "pledge", "name": "Залоги", "status": "done", "level": "ok", "summary": "залогов нет",
"checked_at": "2026-11-10T03:14:11+03:00", "next_at": "2026-11-17T02:00:00+03:00"}
]
}
]
}
| Поле | Значение |
|---|---|
checks[].status | pending: ещё не проверяли. done: проверено. failed: не удалось, деньги не списаны, проверка повторится. skipped, unavailable: проверка сейчас невозможна, причина в summary |
checks[].level | bad, warn, ok: итог последней проверки |
checked_at, next_at | когда проверяли в последний раз и когда проверят снова |
Изменения
GET /monitoring?id=57&events=1&since_id=0&limit=100
{
"success": 1,
"events": [
{
"id": 30417, "kind": "change", "level": "bad",
"check": {"code": "pledge", "name": "Залоги"},
"car": {"id": 9051, "label": "", "vin": "XTA210990Y1234567", "plate": "В456ОР77"},
"title": "Появился залог", "before": "залогов нет", "after": "залог от 09.11.2026",
"requestId": 1840990, "created_at": "2026-11-11T03:14:02+03:00"
}
],
"next_since_id": 30417
}
Запоминайте next_since_id и передавайте его в следующем запросе как since_id: придут только новые события. Чтобы не опрашивать, подпишитесь в разделе «Вебхук» на события мониторинга: monitor.change, monitor.paused, monitor.check_failed.
Списания и лимиты
- Сам метод
/monitoringбесплатный. Списывают проверки мониторинга: по вашим ценам и по правилам каждого метода. - У списка свой лимит расхода в месяц, он задаётся в кабинете. Когда он достигнут, список встаёт на паузу до следующего месяца или до изменения лимита.
- Проверки идут в ночное окно. Первая проверка новой машины выполняется вскоре после добавления.
- Дополнительному токену метод разрешается отметкой «Мониторинг по API».
Коды ошибок
| HTTP | code | Что значит |
|---|---|---|
| 400 | BAD_ITEMS, NO_ITEMS | Список машин не передан или в нём нет ни одного распознанного номера. |
| 400 | BAD_JSON | Тело запроса не разобрано как JSON. |
| 401 | NO_TOKEN, TOKEN_INVALID | Токен не передан или недействителен. |
| 403 | NOT_ALLOWED, IP_NOT_ALLOWED, TOKEN_SCOPE | Мониторинг не подключён аккаунту, IP не в списке разрешённых, либо токену не разрешён этот метод. |
| 404 | LIST_NOT_FOUND, CAR_NOT_FOUND | Нет такого списка или такой машины в списке. |
| 409 | CARS_LIMIT, BUSY | На мониторинге уже максимум машин для аккаунта, либо мониторинг сейчас обновляется: повторите через несколько секунд. |
| 429 | RATE_LIMIT | Слишком частые запросы к методу. Повторите через Retry-After секунд. |
| 503 | PROVIDER_FAIL, NOT_AVAILABLE | Метод временно недоступен. Повторите запрос. |