Deweloperzy
API integracyjne
API JSON tylko do odczytu do pobierania danych o zgodności do własnych systemów: TMS, pulpity, arkusze kalkulacyjne lub narzędzia automatyzacji. Wszystko jest tylko GET - API nigdy nie zmienia Twoich danych.
Autoryzacja
Utwórz klucz API w aplikacji w sekcji Ustawienia > Integracje (tylko właściciele i menedżerowie transportu) i wyślij go jako token nosiciela w każdym żądaniu. Pełny klucz jest wyświetlany tylko raz przy jego tworzeniu; możesz go cofnąć w dowolnym momencie.
curl https://operatorcompliance.co.uk/api/integration/v1/ping \
-H "Authorization: Bearer oc_live_YOUR_KEY"Limity szybkości i paginacja
Każdy klucz może wykonać 60 żądań na minutę; po przekroczeniu limitu API odpowiada 429. Listy są paginowane z ?page= i ?per_page= (domyślnie 50, maksymalnie 100) i opakowane w {data: [...], meta: {current_page, last_page, per_page, total}}.
Błędy
Błędy to JSON z polem wiadomości: 401 za brakujący, nieprawidłowy lub unieważniony klucz, 404 za rekord, który nie istnieje na Twoim koncie, 429 gdy osiągnięto limit.
Punkty końcowe
GET /api/integration/v1/ping
Sprawdzenie łączności: potwierdza, że klucz działa i podaje nazwę konta, do którego należy.
Przykład
{"ok": true, "operator": "Alpha Haulage Ltd", "time": "2026-08-29T10:15:00Z"}GET /api/integration/v1/drivers
GET /api/integration/v1/drivers/{id}
Twoi kierowcy z datami zgodności: status, karta tachografu, pobrania karty, status licencji i termin ważności Driver CPC.
Pola odpowiedzi
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}
Twoje pojazdy i przyczepy: identyfikacja, status, daty MOT i podatku, następna inspekcja bezpieczeństwa, ostatnie pobranie jednostki pojazdu i termin kalibracji tachografu.
Pola odpowiedzi
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
Alerty zgodności. Otwórz alerty domyślnie; dodaj ?status=all, aby uwzględnić potwierdzone i rozwiązane.
Pola odpowiedzi
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}
Raporty o naruszeniach tachografu dla każdego kierowcy i okresu. Punkt końcowy szczegółów zawiera każde naruszenie z datą, powagą, zasadą i szczegółami.
Pola odpowiedzi
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 zwraca tylko dane należące do konta, na którym stworzono klucz, i nigdy nie zwraca zaszyfrowanych identyfikatorów osobistych, takich jak numery prawa jazdy czy numery ubezpieczenia społecznego.
Gotowy, aby przestać gonić za terminami?
Skonfiguruj w jedno popołudnie. Utrzymaj swoją licencję operatora w czystości na zawsze.
14-dniowy darmowy okres próbny · brak karty · anuluj w dowolnym momencie