API-nycklar

Autentisera anrop till Besökskollen Public API med API-nycklar.

Behöver jag en API-nyckel?

API-nycklar behövs om du vill visa besöksbaserad data (t.ex. "Populära produkter") automatiskt på din sajt. Detta kräver en utvecklare eller webbyrå som kan integrera API:et i din sajt.

Om du bara vill se statistik i Besökskollen-dashboarden behöver du ingen API-nyckel.

Vad är API-nycklar?

API-nycklar används för att autentisera anrop till vårt Public API. Varje nyckel är kopplad till en specifik sajt och har en rate limit på 1000 anrop per timme.

Med API-nycklar kan du:

Hämta populära produkter baserat på besöksdata
Visa trendande kategorier på din sajt
Analysera vilka partners som driver mest trafik
Bygga dashboards och integrationer

Skapa en API-nyckel

1. Logga in i Besökskollen och gå till Inställningar
2. Klicka på API-nycklar
3. Klicka Skapa API-nyckel
4. Välj vilken sajt nyckeln ska vara kopplad till
5. Ge nyckeln ett namn (t.ex. "Produktion" eller "Backup")
6. Klicka Skapa

Viktigt

Kopiera och spara API-nyckeln direkt. Den visas endast en gång och kan inte återställas. Om du tappar bort nyckeln måste du skapa en ny.

Använda API-nyckeln

Enkelt förklarat

API-nyckeln är som ett lösenord som bevisar att du har rätt att hämta data. Din utvecklare lägger in nyckeln i koden så att din sajt kan "prata med" Besökskollen.

Ge nyckeln till din utvecklare - de vet hur man använder den.

För utvecklare: Skicka nyckeln i Authorization-headern som en Bearer-token:

curl -H "Authorization: Bearer bk_din_api_nyckel_här" \
  "https://besokskollen.se/api/v1/popular/products?site_id=din-sajt"

Tillgängliga endpoints

Endpoint	Beskrivning
`GET /api/v1/popular/products`	Populära produkter baserat på klick
`GET /api/v1/popular/categories`	Populära kategorier
`GET /api/v1/popular/partners`	Partner-statistik och trafikandelar
`POST /api/v1/batch`	Hämta flera endpoints i ett anrop

Rate limiting

Varje API-nyckel har en rate limit på 1000 anrop per timme. Om du överskrider gränsen får du ett 429 Too Many Requests-svar.

Rate limit-status returneras i response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1704067200

Exempel

Hämta de 10 mest populära produkterna de senaste 7 dagarna:

curl -H "Authorization: Bearer bk_abc123..." \
  "https://besokskollen.se/api/v1/popular/products?site_id=mobildelar-se&days=7&limit=10"

Response:

{
  "data": [
    {
      "product_id": "iphone-15-skal-svart",
      "product_slug": "iphone-15-skal-svart",
      "clicks": 47
    },
    {
      "product_id": "samsung-s24-skarmskydd",
      "product_slug": "samsung-s24-skarmskydd",
      "clicks": 35
    }
  ],
  "meta": {
    "period": {
      "from": "2025-01-01T00:00:00Z",
      "to": "2025-01-07T23:59:59Z"
    },
    "total_clicks": 523,
    "confidence": "high"
  }
}

Säkerhetstips

Spara aldrig API-nycklar i klientkod eller publika repositoryn
Använd miljövariabler för att lagra nycklar
Skapa separata nycklar för olika ändamål
Rotera nycklar regelbundet för ökad säkerhet
Ta bort oanvända nycklar

Event Properties →Public API-referens →