Личный кабинет

Главная → Документация → Мониторинг по API

Мониторинг по API

Мониторинг сам перепроверяет машины по расписанию и сообщает, когда что-то изменилось: появился залог, ограничение, новый владелец, истекает полис. Список мониторинга с проверками и частотой вы заводите в личном кабинете, а метод /monitoring позволяет вашей системе добавлять и убирать машины и забирать изменения.

Машины из вашей системыИзменения вебхукомЛимит списка в месяц

Как это устроено

Списки

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}
}

Убрать машину

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[].statuspending: ещё не проверяли. done: проверено. failed: не удалось, деньги не списаны, проверка повторится. skipped, unavailable: проверка сейчас невозможна, причина в summary
checks[].levelbad, 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.

Списания и лимиты

Коды ошибок

HTTPcodeЧто значит
400BAD_ITEMS, NO_ITEMSСписок машин не передан или в нём нет ни одного распознанного номера.
400BAD_JSONТело запроса не разобрано как JSON.
401NO_TOKEN, TOKEN_INVALIDТокен не передан или недействителен.
403NOT_ALLOWED, IP_NOT_ALLOWED, TOKEN_SCOPEМониторинг не подключён аккаунту, IP не в списке разрешённых, либо токену не разрешён этот метод.
404LIST_NOT_FOUND, CAR_NOT_FOUNDНет такого списка или такой машины в списке.
409CARS_LIMIT, BUSYНа мониторинге уже максимум машин для аккаунта, либо мониторинг сейчас обновляется: повторите через несколько секунд.
429RATE_LIMITСлишком частые запросы к методу. Повторите через Retry-After секунд.
503PROVIDER_FAIL, NOT_AVAILABLEМетод временно недоступен. Повторите запрос.