API for utviklere og AI-verktøy

Sporløs har et read-only Stats-API så du kan hente tallene dine inn i rapporter, regneark og AI-verktøy. Det er trygt å dele en nøkkel med en AI-assistent: API-et serverer kun aggregater — enkeltpersoner kan ikke slås opp, fordi rådataene ikke finnes (ingen IP, ingen cookie, daglig-roterende hash).

Kom i gang

Lag en nøkkel under «API-tilgang» i dashbordet, og send den som Bearer-token:

curl -H "Authorization: Bearer sl_..." \
  "https://sporlos.no/api/v1/stats?site=DIN_SITE_ID&period=7"

site er nettstedets public-ID (samme som i sporings-snippeten — eller hent alle med /api/v1/sites). period er 1, 7 eller 30 dager.

Endepunkter

`GET /api/v1/sites`	nettstedene dine (domene + site-ID)
`GET /api/v1/stats`	KPI-er (unike, visninger, økter, fluktrate) + topplister, med forrige periode til sammenligning
`GET /api/v1/timeseries`	per dag (per time når period=1)
`GET /api/v1/breakdown`	full liste per dimensjon: `prop=pages\|sources\|countries\|regions\|devices\|browsers\|os` (+ `limit`, maks 1000)
`GET /api/v1/goals`	mål/konverteringer med rate
`GET /api/v1/events`	egendefinerte hendelser
`GET /api/v1/ecommerce`	e-handel: ordrer + omsetning per valuta, toppprodukter, omsetning per kilde og per betalingsmåte (beløp i øre)
`GET /api/v1/anchors`	forseglede dags-aggregater: sha256-hash + blokkjede-txid — bevis på at historiske tall ikke er endret i etterkant

Alle svar er JSON. Land returneres som ISO-koder. Feil gir {"error": "..."} med 400/401/404. Nøkler kan trekkes tilbake når som helst i dashbordet.

E-handel: send kjøp

Kall sporlos('purchase', …) fra ordrebekreftelsen, så får du omsetning, ordrer, snittordre, toppprodukter og omsetning per kilde i dashbordet:

sporlos('purchase', {
  revenue: 1198,           // ordresum i kroner
  currency: 'NOK',         // valgfri, NOK er standard
  payment: 'vipps',        // valgfri betalingsmåte-slug, f.eks. vipps/stripe_card/klarna
  items: [
    { name: 'eSIM Europa 10 GB', qty: 2, price: 599 }
  ]
});

Kun beløp, produktnavn og ev. betalingsmåte (kort slug som «vipps» — fritekst avvises) sendes — vi ber aldri om ordre-ID eller kundedata, og det finnes ikke felt for dem. Ikke send ordrenummer eller personaliserte produktnavn (gravering o.l.) i navnefeltet. Fyr kallet én gang per fullført ordre (typisk gated på en parameter fra betalings-redirecten, ikke på hver visning av kvitteringssiden). Tallene rapporteres av kundens nettleser og er veiledende — bruk ordresystemet, ikke analysen, som regnskaps- og avregningsgrunnlag.

Eksempel: spør en AI om tallene dine

Lim denne siden + nøkkelen din inn i Claude eller ChatGPT og be den f.eks. «hent siste 30 dager for nettstedet mitt og forklar hva som driver trafikken». Verktøy som kan gjøre HTTP-kall trenger ikke mer enn dette.