Integrer selvbetjening på noen minutter

La kunden bestille egne behandlingstimer hel-automatisk etter meldt skade. Via API-er kan polise og eventuell henvisning verifiseres. Saksopplysninger sendes automatisk slik at kunden ikke behøver fylle inn opplysninger. Prosessen er sikret med BankID.

Hvorfor velge Speare Selvbetjening?

Automatisert arbeidsflyt

Opprett sak → Kunde får lenke → Selvbetjent bestilling → Overført til behandler

BankID-verifisert

Kunden autentiseres med norsk BankID for sikker identitetsverifisering

Sanntids tilgjengelighet

Live tilgjengelighet for psykologer/behandlere fra integrerte bookingsystemer

Flerkanals varsling

Innebygde e-post- og SMS-varsler til kunden

Slik fungerer det

1

Partner oppretter sak

API-kall med kundedetaljer

2

Kunde varsles

E-post/SMS med bookinglenke

3

Logg inn og bestill

BankID, velg tid, bekreft

4

Overført til behandler

Bestilling sendes automatisk

Kom i gang

Kom i gang med 3 enkle steg:

1

Få din API-nøkkel

Kontakt oss på support@speare.no for å få din partnerkonto og API-nøkkel. Vi setter deg opp med sandbox-tilgang for testing.

2

Opprett en sak

Send kundedetaljer via API. De mottar automatisk en bookinglenke.

curl -X POST "https://test.behandlingsdekning.no/api/v1/cases" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "partnerCaseId": "CASE-123",
    "patientFirstName": "Ola",
    "patientLastName": "Nordmann",
    "patientEmail": "ola@example.no",
    "patientPhone": "+47 12345678",
    "injuryDate": "2024-01-15",
    "injuryDescription": "Ryggskade etter bilulykke",
    "treatmentType": "fysioterapi",
    "bookingDeadline": "2024-02-15"
  }'
3

Kunden bestiller automatisk

Kunden mottar en e-post/SMS med sin unike bookinglenke. De logger inn med BankID, ser tilgjengelige tider og bekrefter sin time. Bestillingen overføres automatisk til behandleren.

Teknisk referanse

Komplett API-dokumentasjon for utviklere

Base URL

https://test.behandlingsdekning.no/api/v1

Autentisering

API-et bruker API-nøkkel for autentisering. Inkluder din API-nøkkel i request-headeren:

X-API-Key: your-api-key-here

Ratebegrensning

Ratebegrensning gjelder alle API-forespørsler
  • Offentlig100 forespørsler per minutt
  • Autentisert500 forespørsler per minutt
  • Innlogging5 forespørsler per 15 minutter

Feilresponser

Alle feil følger et konsistent JSON-format:

{
  "error": "Invalid API key",
  "statusCode": 401,
  "details": {
    "code": "INVALID_API_KEY"
  }
}

Saks-endepunkter

Autentisering påkrevd
Alle saks-endepunkter krever en gyldig X-API-Key header.

Booking-endepunkter

Offentlig tilgang
Disse endepunktene brukes av kunden via deres unike saks-UUID. Ingen API-nøkkel kreves.

Partner-autentisering

Webhooks

Kommer snart
Partnere vil kunne registrere webhooks for å motta sanntidsoppdateringer om saksstatusendringer. Denne funksjonen er planlagt for en fremtidig versjon.

HTTP-statuskoder

KodeBeskrivelse
200Vellykket forespørsel
201Ressurs opprettet
400Ugyldig forespørsel - Feil i inndata
401Ikke autorisert - Ugyldig eller manglende API-nøkkel
403Forbudt - Ingen tilgang
404Ikke funnet - Ressursen eksisterer ikke
429For mange forespørsler - Rategrense overskredet
500Intern serverfeil

Saksstatusverdier

StatusBeskrivelse
pending_patient_actionVenter på at kunden skal bestille time
bookedKunden har bestilt time
deadline_expiredBestillingsfristen har utløpt
assistance_requestedKunden har bedt om hjelp med bestilling
recalledSaken er tilbakekalt av partner
archivedSaken er arkivert
errorFeil ved behandling av saken

Klar til å integrere?

Kom i gang i dag med vårt brukervennlige API. Teamet vårt er klare til å hjelpe deg med å integrere selvbetjening i din forsikringsarbeidsflyt.

E-post: support@speare.no

© 2026 Speare Teknologi