Logga inSkapa kontoMina sidor

Rättkoll är en oberoende tjänst, inte en myndighet.

För utvecklare

Rättkoll API

Kör kollen i era egna system. Skicka några svar om en person eller ett företag och få tillbaka vilka stöd, bidrag och avdrag som kan passa, med källor och nästa steg.

Skapa konto och testnyckelSe priserLadda ner OpenAPI
  1. 1

    Skapa ett företagskonto

    Gratis. Nycklar hanteras av företagets ägare.

  2. 2

    Skapa en testnyckel

    Under API i företagsportalen. Testmiljön är gratis, 100 kontroller per dag.

  3. 3

    Gör ert första anrop

    Med produktionsnyckel när ni har tecknat Rättkoll API.

Första anropet

curl https://rattkoll.se/api/v1/screening/match \
  -H "Authorization: Bearer rk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"audience": "business", "locale": "sv",
       "profile": {"company_sweden": true, "hiring": true}}'

Svaret innehåller matches (stöd som kan passa eller som behöver fler svar), followups (frågor som avgör fler stöd), sources för varje stöd, catalog_version och request_id. Testnycklar ger samma resultat som produktion, markerat med "test": true.

Anrop

AnropVad det gör
POST /api/v1/screening/matchKör kollen för en profil. Räknas som en kontroll när det lyckas.
GET /api/v1/screening/fieldsFrågorna profilen kan innehålla, med typ, tillåtna värden och frågetext. Gratis.
GET /api/v1/screening/supportsAlla stöd i katalogen med källor och granskningsdatum. Gratis.
GET /api/v1/screening/usageErt företags användning den här månaden. Gratis.

Lägg till audience=individual eller audience=business och locale=sv eller locale=en där det passar.

Nycklar och säkerhet

Skicka nyckeln i Authorization: Bearer <nyckel>. Testnycklar börjar med rk_test_ och produktionsnycklar med rk_live_. En nyckel visas bara en gång när den skapas, och vi sparar bara en envägs-kod av den.

Anropa API:t från er server. Lägg aldrig en nyckel i en webbsida eller app. Återkalla en nyckel direkt i företagsportalen om den kan ha läckt, den slutar fungera på en gång.

Gränser och användning

GränsVärde
Anrop per nyckel20 per sekund och 600 per minut
Testmiljön100 kontroller per företag och dag
Kontroller i planenEnligt er plan, räknas per kalendermånad

Över planens kontroller fortsätter API:t att fungera. Ni får besked vid 80 % och 100 %, och vi hör av oss om en plan som passar er volym. Svaren med produktionsnyckel har X-Rattkoll-Checks-Used och X-Rattkoll-Checks-Included.

Felkoder

Fel ser alltid ut så här: {"error": {"code": "…", "message": "…", "request_id": "req_…"}}. Ange request_id när ni kontaktar oss.

KodBetyder
401 invalid_keyNyckeln saknas, är okänd eller återkallad.
402 subscription_inactiveProduktionsnyckel utan aktiv plan.
429 rate_limitedFör många anrop. Vänta enligt Retry-After.
429 test_limitTestmiljöns kontroller för dagen är slut.
400Profilen har okända fält, fel typ eller fält för en annan målgrupp.

Integritet och ansvar

Profilen får bara innehålla frågorna från /fields. Personnummer, namn och andra identiteter avvisas. Vi sparar aldrig profilen eller resultatet, bara hur många anrop varje nyckel gör per dag.

Resultaten är vägledning med källor, aldrig beslut. Det är alltid myndigheten eller den som ger stödet som beslutar. Visa gärna källan och texten i disclaimer för era användare.

Frågor

Skriv till rattkoll@accruvia.se om ni vill prata volym, avtal eller integration.