Dezvoltatori
API de integrare
Un API JSON doar pentru citire pentru extragerea datelor tale de conformitate în sistemele tale: TMS, tablouri de bord, foi de calcul sau instrumente de automatizare. Totul este doar GET - API-ul nu îți schimbă datele.
Autentificare
Creează o cheie API în aplicație sub Setări > Integrare (doar pentru proprietari și manageri de transport) și trimite-o ca token bearer cu fiecare cerere. Cheia completă este afișată o singură dată când este creată; o poți revoca oricând.
curl https://operatorcompliance.co.uk/api/integration/v1/ping \
-H "Authorization: Bearer oc_live_YOUR_KEY"Limite de rată și paginare
Fiecare cheie poate face 60 de cereri pe minut; peste limită, API-ul răspunde cu 429. Listele sunt paginate cu ?page= și ?per_page= (implicit 50, maxim 100) și învelite în {data: [...], meta: {current_page, last_page, per_page, total}}.
Erori
Erorile sunt JSON cu un câmp de mesaj: 401 pentru o cheie lipsă, invalidă sau revocată, 404 pentru un record care nu există în contul tău, 429 când limita de rată este atinsă.
Puncte finale
GET /api/integration/v1/ping
Verificare conectivitate: confirmă că cheia funcționează și numele contului la care aparține.
Exemplu
{"ok": true, "operator": "Alpha Haulage Ltd", "time": "2026-08-29T10:15:00Z"}GET /api/integration/v1/drivers
GET /api/integration/v1/drivers/{id}
Șoferii tăi cu datele lor de conformitate: statut, card tahograf, descărcări de carduri, statut licență și expirarea Driver CPC.
Câmpuri de răspuns
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}
Vehiculele și remorcile tale: identitate, statut, date MOT și impozit, următoarea inspecție de siguranță, ultima descărcare a unității vehiculului și data limită pentru calibrarea tahografului.
Câmpuri de răspuns
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
Alerte de conformitate. Alertele sunt deschise în mod implicit; adaugă ?status=all pentru a include cele recunoscute și rezolvate.
Câmpuri de răspuns
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}
Rapoarte de încălcare a tahografului pe șofer și perioadă. Punctul final de detaliu include fiecare încălcare cu data, severitatea, regula și detaliile.
Câmpuri de răspuns
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-ul returnează doar date care aparțin contului pe care a fost creată cheia și nu returnează niciodată identificatori personali criptati, cum ar fi numerele de licență de conducere sau numerele de asigurare națională.
Pregătit să încetați să urmăriți datele?
Configurați într-o după-amiază. Mențineți licența operatorului curată pentru totdeauna.
Trial gratuit de 14 zile · fără card · anulează oricând