Bygg reviderbare, forklarbare bomkostnader inn i arbeidsflyten for flåte, refusjon eller regnskap

Hvem dette er for

Autentisering

API-et autentiserer hver forespørsel med et Entra ID (Azure AD) bearer-token i standard Authorization-forespørselshode, hentet via en OAuth2 client-credentials-grant mot din egen Entra-appregistrering, avgrenset til dette API-et. Dette er foreløpig ikke selvbetjent registrering: i dag er den eneste klargjorte kalleren kalkulatorens egen backend-for-frontend (BFF), som autentiserer på tjenersiden (managed identity i Azure) og kaller API-et gjennom APIM, slik at nettleseren aldri ser et token eller en nøkkel. For å integrere direkte, ta kontakt — vi klargjør en dedikert Entra-appregistrering (eller godtar din managed identity) avgrenset til å kalle API-et, slik at systemet ditt autentiserer uavhengig av vår web-frontend.

# Eksempel: hente et token via client-credentials (illustrerende — dine tenant-/scope-verdier er andre)
curl -s -X POST "https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token" \
  -d "grant_type=client_credentials" \
  -d "client_id=<din-client-id>" \
  -d "client_secret=<din-client-secret>" \
  -d "scope=api://<api-app-id>/.default"

Beregn én bomkostnad Verifisert live 13.08.2026

POST /api/toll-calculation/calculations — startpunkt, endepunkt, inntil 3 mellompunkter, en kjøretøyprofil og et avreisetidspunkt. vehicle.class er en to-nivås enum (small / large) — tungbiler i takstgruppe 2 mappes til large.

# Forespørsel
POST /api/toll-calculation/calculations
Authorization: Bearer <token>
Content-Type: application/json
Idempotency-Key: 3fae9f2e-1c2b-4e9a-9b1a-8e0f6c1d2a77

{
  "origin": { "lat": 59.9139, "lon": 10.7522, "label": "Oslo" },
  "destination": { "lat": 60.3913, "lon": 5.3221, "label": "Bergen" },
  "waypoints": [],
  "vehicle": { "class": "small", "fuelType": "petrol", "autopassAgreement": true },
  "departureTime": "2026-08-20T10:00:00Z",
  "hourlyRuleEnabled": true,
  "rushHourEnabled": true
}

# Svar — 201 Created (200 OK ved en Idempotency-Key-replay av samme forespørsel)
{
  "calculationId": "01KZXHDJE9ZNEJR9JJ2BA38SW8",
  "totalAmount": 729.0,
  "currency": "NOK",
  "crossesBorder": false,
  "passageCount": 14,
  "routeSource": "OSRM_PUBLIC",
  "warnings": [],
  "createdAt": "2026-08-13T12:26:15Z",
  "route": {
    "distanceMeters": 463000,
    "durationSeconds": 21600,
    "polyline": [ { "lat": 59.9139, "lon": 10.7522 } /* … ett koordinatobjekt per rutepunkt */ ]
  },
  "alternatives": [ "… inntil 2 alternative ruter, samme form som hovedresultatet …" ],
  "passages": [
    {
      "index": 0,
      "tollStationNvdbId": "929790703",
      "tollStationName": "Dronning Blancas vei",
      "bompengeprosjektKey": "FJELLINJEN_OSLORINGEN",
      "country": "NO",
      "timestamp": "2026-08-20T12:03:53+02:00",
      "basePrice": 42.0,
      "appliedPeriod": "OFF_PEAK",
      "finalAmount": 42.0,
      "currency": "NOK",
      "suppressedByHourlyRule": false
    }
  ]
}

Idempotency-Key

Send en klientgenerert UUID som Idempotency-Key på hver POST /calculations. Å gjenta samme nøkkel med identisk innhold returnerer det opprinnelige resultatet (200 OK, samme calculationId) i stedet for å opprette et duplikat — trygt å prøve på nytt etter et nettverkstidsavbrudd. Å gjenbruke samme nøkkel med et annet innhold returnerer 409 Conflict, så generer alltid en fersk nøkkel per distinkt forespørsel, ikke per nytt forsøk. (Merk at dette gjelder enkeltberegninger — batch-innsending er foreløpig ikke idempotent, se neste seksjon.)

Batch-beregninger (opptil 10 000 forespørsler) Verifisert live 13.08.2026

For en hel dags kjøreplan eller en samlet refusjonskjøring: send mange forespørsler i ett kall og poll for fullføring i stedet for å gjøre tusenvis av synkrone kall.

# 1. Send inn — 202 Accepted
POST /api/toll-calculation/calculation-batches
Authorization: Bearer <token>
Content-Type: application/json

{ "requests": [ { "origin": { "...": "..." }, "destination": { "...": "..." }, "waypoints": [], "vehicle": { "class": "small", "fuelType": "petrol" }, "departureTime": "2026-08-20T10:00:00Z" } /* … opptil 10 000 */ ] }

{
  "batchId": "01KZXHEE6W67RRB4JSHG0X2CGQ",
  "acceptedAt": "2026-08-13T12:27:10Z",
  "statusUrl": "/api/toll-calculation/calculation-batches/01KZXHEE6W67RRB4JSHG0X2CGQ",
  "estimatedCompletionSeconds": 2
}

# 2. Poll statusUrl til status ikke lenger er RUNNING
GET /api/toll-calculation/calculation-batches/01KZXHEE6W67RRB4JSHG0X2CGQ
Authorization: Bearer <token>

{
  "batchId": "01KZXHEE6W67RRB4JSHG0X2CGQ",
  "status": "RUNNING",
  "totalRequests": 2,
  "completed": 0,
  "failed": 0,
  "results": [],
  "errors": [],
  "updatedAt": "2026-08-13T12:27:11Z"
}
# status: RUNNING → COMPLETED (eller PARTIALLY_COMPLETED). results[] inneholder ett
# CalculateTollResponse per vellykket forespørsel (samme form som enkeltkall-endepunktet
# over); errors[] inneholder { requestIndex, code, message } for hver forespørsel i
# batchen som feilet.

Dataferskhet og resultatsemantikk

Hva du kan stole på i dag, verifisert mot det utrullede TEST-miljøet:

Rategrenser og feil

Nåværende grense i TEST-miljøet: 60 forespørsler/minutt per kaller, fast vindu; et 429-svar inkluderer et Retry-After-hint. Produksjonsgrenser avtales per integrasjon når tilgang klargjøres — spør når du ber om tilgang.

Feil følger RFC7807 application/problem+json:

Få tilgang

Dette API-et er foreløpig ikke selvbetjent. For å få en dedikert Entra-appregistrering (eller registrere din managed identity) klargjort for din integrasjon mot flåte, refusjon eller regnskap, ta kontakt med din AutoSync-kontaktperson eller TollCalculation-produktteamet — referer til dette API-et og bruksområdet (flåte, refusjon eller regnskap) slik at vi kan avgrense riktig tilgang og rategrense for integrasjonen din.