API de integrare

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

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, third_party, awaiting_review, 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}]

POST /api/integration/v1/ddd-files

Permisiune: tacho:write

Încarcă o descărcare de pe cardul șoferului sau din unitatea vehiculului ca multipart/form-data în câmpul "file", de până la 20 MB. Trece prin aceleași verificări ca o încărcare în aplicație: conținutul trebuie să fie o descărcare tahograf (altfel 422 și nu se salvează nimic), un fișier deja existent în cont nu este salvat de două ori (200 cu duplicate true în loc de 201) și este pus în coadă pentru citire, potrivire cu șoferii și vehiculele tale și analiză.

Exemplu

curl https://operatorcompliance.co.uk/api/integration/v1/ddd-files \
  -H "Authorization: Bearer oc_live_YOUR_KEY" \
  -F "file=@driver-card.ddd"

GET /api/integration/v1/ddd-files

GET /api/integration/v1/ddd-files/{id}

Permisiune: tacho:write / reports:read

Fișierele tale tahograf și starea procesării lor, cele mai noi primele. Filtrează cu ?kind=driver_card|vehicle_unit, ?status=pending|parsed|failed și ?uploaded_since=YYYY-MM-DD. După o încărcare, interoghează punctul final de detaliu pentru a vedea când fișierul a fost citit.

Câmpuri de răspuns

id, kind, parse_status, parse_error, signature_valid, original_name, size, sha256, card_number, vrn, vin, driver {id, name}, vehicle {id, display_identifier}, period_from, period_to, download_time, uploaded_at; an upload adds duplicate

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

Permisiune: reports:read

Raportul tahograf în PDF: copia semnată de șofer, dacă există, altfel raportul așa cum a fost emis. Copiile stocate sunt verificate mai întâi cu suma de control înregistrată; un raport fără PDF sau a cărui copie nu trece această verificare răspunde cu 409.

GET /api/integration/v1/vehicles/{id}/status.pdf

GET /api/integration/v1/drivers/{id}/status.pdf

Permisiune: reports:read

Fișa de o pagină cu starea de conformitate a unui vehicul sau a unui șofer, ca în aplicație, în limba contului tău. Fișa șoferului din API nu include data nașterii și numărul permisului de conducere.