Разработчици

Интеграционен API

Четивен JSON API за извличане на вашите данни за съответствие в собствените ви системи: TMS, табла, електронни таблици или инструменти за автоматизация. Всичко е само GET - API никога не променя вашите данни.

Аутентификация

Създайте API ключ в приложението под Настройки > Интеграции (само за собственици и транспортни мениджъри) и го изпратете като токен за носител с всяка заявка. Пълният ключ се показва веднъж, когато бъде създаден; можете да го оттеглите по всяко време.

curl https://operatorcompliance.co.uk/api/integration/v1/ping \
  -H "Authorization: Bearer oc_live_YOUR_KEY"

Ограничения на скоростта и странициране

Всеки ключ може да направи 60 заявки на минута; над лимита API отговаря с 429. Списъците са страницирани с ?page= и ?per_page= (по подразбиране 50, максимум 100) и обвити в {data: [...], meta: {current_page, last_page, per_page, total}}.

Грешки

Грешките са JSON с поле за съобщение: 401 за липсващ, невалиден или оттеглен ключ, 404 за запис, който не съществува в акаунта ви, 429 когато е достигнат лимитът на скоростта.

Краища

GET /api/integration/v1/ping

Проверка на свързаност: потвърдете, че ключът работи и посочете акаунта, към който принадлежи.

Пример

{"ok": true, "operator": "Alpha Haulage Ltd", "time": "2026-08-29T10:15:00Z"}

GET /api/integration/v1/drivers

GET /api/integration/v1/drivers/{id}

Вашите шофьори с техните дати на съответствие: статус, карта на тахографа, изтегляния на карти, статус на лиценз и изтичане на Driver CPC.

Полета на отговора

id, first_name, last_name, status, employed_from, tacho_card_number, tacho_card_expiry_on, last_card_download_on, next_card_download_due_on, licence_status, licence_valid_to, cpc_expiry_on

GET /api/integration/v1/vehicles

GET /api/integration/v1/vehicles/{id}

Вашите превозни средства и ремаркета: идентичност, статус, дати на MOT и данъци, следваща безопасна инспекция, последно изтегляне на единица превозно средство и срок за калибриране на тахографа.

Полета на отговора

id, identifier, display_identifier, vin, make, model, fleet_number, type, status, mot_status, mot_expiry_on, tax_status, tax_due_on, next_si_due_on, last_vu_download_on, next_vu_download_due_on, tacho_calibration_due_on

GET /api/integration/v1/alerts?status=open|all

Предупреждения за съответствие. Отворени предупреждения по подразбиране; добавете ?status=all, за да включите потвърдени и разрешени.

Полета на отговора

id, type, severity, status, title, message, due_on, created_at, alertable {type, id, label}

GET /api/integration/v1/tacho-reports

GET /api/integration/v1/tacho-reports/{id}

Доклади за нарушения на тахографа по шофьор и период. Детайлният край включва всяко нарушение с неговата дата, тежест, правило и детайл.

Полета на отговора

id, reference, driver {id, name}, period_from, period_to, status, infringement_count, highest_severity, sent_at, signed_at, created_at; detail adds infringements [{date, severity, rule, detail}]

API-то винаги връща данни, принадлежащи на акаунта, на който е създаден ключът, и никога не връща криптирани лични идентификатори, като номера на шофьорски книжки или номера на национално осигуряване.

Готови ли сте да спрете да гоните дати?

Настройте за един следобед. Поддържайте вашата операторска лицензия чиста завинаги.

Започнете безплатния си пробен период Контакт

14-дневен безплатен пробен период · без карта · анулирайте по всяко време