Happypath™ API-er

Dørdata der du trenger dem

Opprett innsamlingsforespørsler fra ordresystemet, få inngang, gangsti og dørbilder tilbake, og gi budet en lenke med veibeskrivelse. Det er de samme dataene Companion bruker, gjennom et REST-API, en komponent for kassen eller en MCP-server for KI-assistenter.

Få API-tilgang OpenAPI-spesifikasjon

Ordrene til Svisj i Happypath-partnerportalen: for hver forespørsel ser du om adresse, leietaker og dør ble funnet

Fire innganger

Velg det som passer systemene deres

Alle fire bygger på de samme dørene, stiene og bildene.

Server

REST-API

Opprett innsamlingsforespørsler og hent dør, sti, leietaker og bilder. JSON over HTTPS med en Bearer-nøkkel. Lenken deler dere selv.

Nettleser

Checkout-komponent

En React-komponent for kassen. Kunden velger mottaker og inngang, og dør-ID-en følger ordren.

Happypath™ Checkout →

KI-assistenter

MCP-server

La ChatGPT, Claude eller Cursor slå opp innganger, forklare veien de siste meterne med bilder og foreslå rettelser.

I alle svar

Lenker med veibeskrivelse

Svarene har en Happypath-lenke og et kartbilde som åpnes i alle nettlesere. Legg den på ordren, bookingen eller SMS-en.

Slik henger det sammen

Fra adresse til dør i to kall

Eksempelet er en ekte forespørsel til Happypath-kontoret i Colletts gate 43, laget med en testnøkkel for Svisj.

1 · Opprett

Send adressen og ordrenummeret

Kjenner vi døren allerede, kommer forespørselen tilbake delvis utfylt. Uansett får du en innsamlingslenke til mottakeren og en lenke med veibeskrivelse til budet.

POST /api/v1/happypath_request

curl -X POST https://api.happypath.no/api/v1/happypath_request \
  -H "Authorization: Bearer $HAPPYPATH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "street_name": "Colletts gate",
      "street_number": "43",
      "postcode": "0456",
      "postarea": "Oslo"
    },
    "apartment_id": "Happypath",
    "customer_reference": "SV-10422"
  }'

{
  "object": "happypath_request",
  "input_state": "PARTIALLY_FILLED",
  "customer_reference": "SV-10422",
  "urls": {
    "end_user": "https://go.happypath.no/c/KlXW_kHoNR",
    "courier": "https://go.happypath.no/v/KlXW_kHoNR"
  }
}

2 · Hent

Hent dørdataene når du trenger dem

Inngang, gangsti, leietaker, etasje, dørbilder og et kartbilde, klart for TMS, CRM eller kundeservice. Søk på adresse når du ikke har en forespørsel.

GET /api/v1/happypath_request/collected_data/{slug}

GET /api/v1/happypath_request/collected_data/KlXW_kHoNR

{
  "object": "collected_data",
  "street_address": {
    "street_name": "Colletts gate",
    "number": "43",
    "post_area_code": "0456"
  },
  "entry_door": {
    "id": "edo_rf1BkuHaQveM",
    "coordinates": { "lat": 59.92933, "lng": 10.74121 }
  },
  "entry_door_path": { "id": "edp_Uk6qOad2y0yi", "linestring": [ … ] },
  "tenant": { "business_name": "Happypath", "apartment_id": "Happypath" },
  "metadata": {
    "entry_door": [{ "attr_name": "ELEVATOR", "attr_value": "false" }],
    "entry_door_path": [
      { "attr_name": "TROLLEY_FRIENDLY", "attr_value": "true" }
    ],
    "tenant": [
      { "attr_name": "FLOOR", "attr_value": "3" },
      { "attr_name": "CALLING_ID", "attr_value": "Happypath" }
    ]
  },
  "images": {
    "door_image_url": "https://…",
    "map_image_url": "https://…"
  },
  "urls": { "directions_page": "https://go.happypath.no/v/KlXW_kHoNR" }
}

Endepunkter

Hele REST-API-et på én side

Base-URL https://api.happypath.no/api/v1. Autentiser fra serveren deres med en hemmelig API-nøkkel fra partnerportalen som Bearer-token.

Innsamlingsforespørsler

POST/happypath_request
Opprett en forespørsel for en adresse. Svaret har innsamlingslenken til mottakeren og veibeskrivelsen til budet.
GET/happypath_request
List forespørslene deres, filtrert på status.
GETPATCHDELETE/happypath_request/{id}
Les, oppdater eller slett én forespørsel.

Dørdata

GET/happypath_request/collected_data/{slug}
Alt som er samlet inn for en forespørsel: adresse, inngang, gangsti, leietaker, detaljer, dørbilder og et kartbilde.
GET/search?q={address}
Finn dørdata på adresse uten en forespørsel, eventuelt for én leilighet eller bedrift.

Kart og adresser

GET/happypath-image
Et statisk kartbilde av stien frem til døren, for varsler, kundeservice og forhåndsvisninger.
GET/addresses/bbox
Adressene i et lite kartutsnitt med kartleggingsstatus, opptil 250 per kall.

KI-assistenter og nettleseren

POST/mcp
Model Context Protocol for ChatGPT, Claude, Cursor og andre MCP-klienter.
GETPOST/api/sdk/…
Det Checkout-komponenten kaller fra nettbutikkens godkjente domener, med en publiserbar nøkkel. Du kaller dem ikke selv.

Last ned OpenAPI-spesifikasjonen →

MCP-server

La KI-assistenter finne døren

Legg Happypath til i ChatGPT, Claude eller Cursor og spør om veien inn. Svarene kommer fra de samme dørene, stiene og bildene budene bruker, med en Happypath-lenke og et kart.

ChatGPT: legg til https://api.happypath.no/api/v1/mcp og logg inn med Happypath-kontoen.
Claude, Cursor og andre MCP-klienter: samme adresse, med API-nøkkelen deres.
Søk etter adresser og bedrifter, forklar veien, lag et kartbilde, foreslå en rettelse eller opprett en innsamlingsforespørsel.
Rettelser blir gjennomgått før de publiseres.

Ekte svar fra explain_directions

explain_directions({ "query": "Happypath offices" })

# Directions to Happypath at Colletts gate 43, 0456 OSLO

Happypath directions: https://go.happypath.no/v/tnt_BiAljmn4mZwC
There is no elevator.
Approach on foot. The approach is trolley-friendly.

## Tenants
- Happypath (matched) — floor 3 — calling ID Happypath

+ a Happypath map, the entrance photo and the office door photo

Partnerportalen

Alt rundt API-et på ett sted

Utviklerne og driften deres jobber i samme arbeidsflate på partner.happypath.no.

Nøkler og godkjente domener

Hemmelige nøkler for serverne deres, én per system, og publiserbare nøkler for Checkout-komponenten i nettleseren. Trekk en nøkkel tilbake med ett klikk, og godkjenn domenene nettbutikken kjører på.

Følg hver forespørsel

Ordrenummer, om adresse, leietaker og dør ble funnet, og hvor langt mottakeren har kommet. Åpne kartet, eller opprett en forespørsel for hånd.

Interaktiv dokumentasjon

Prøv hvert endepunkt med deres egen nøkkel, med eksempler i cURL og JavaScript.

Bruksstatistikk

Opprettede forespørsler, kall mot dørdata, åpnede veibeskrivelser og opplåsinger i Companion, per dag.

Checkout-lekeplass

Prøv Checkout-komponenten i en demobutikk før dere installerer den.

Import av stopplister

Gjør et skjermbilde fra TMS, en fraktetikett eller en PDF om til en liste med stopp.

Profil, team og fakturering

Logo, farger og tekster for innsamlingslenkene, inviter kolleger, ta inn sjåfører med en QR-kode og se aktive enheter per måned.

Bygget for ekte driftsdata

Dere bestemmer hvem som ser det

Det dere samler inn er åpent som standard, så alle bud får nytte av det, eller privat for organisasjonen deres hvis dere trenger det.

Begrenset til landet deres

Adressesøk og treff følger landet på kontoen deres.

Vanskelig å skrape

Kartutsnitt er begrenset til små områder og 250 adresser per kall.

Hvert kall telles

Bruken vises i partnerportalen, fordelt på flate.

Bygg på de siste meterne

API-tilgang slås på per konto. Fortell oss hva dere bygger, så slår vi den på for dere.

Snakk med oss Åpne partnerportalen