Utvecklardokumentation

Autentisering

Bolio använder API-nycklar för server-till-server-integrationer och OAuth för appar som agerar å en användares vägnar.

API-nycklar

Skapa en nyckel under Inställningar → API. Nyckeln visas bara en gång — spara den säkert. Använd den som Bearer-token i Authorization-headern.

Authorization: Bearer sk_live_abcdef0123456789

Behörigheter

Varje nyckel har scope: read, write eller admin. Välj minsta möjliga scope för din integration.

scope=read      // GET only
scope=write     // GET + create/update
scope=admin     // full access incl. keys, webhooks

OAuth 2.0

För appar som integreras åt flera kunder använder Bolio OAuth 2.0 med auktoriseringskod-flödet. Se webhooks-dokumentationen för callback-konvention.

GET  /oauth/authorize?response_type=code&client_id=...&redirect_uri=...
POST /oauth/token   { grant_type: "authorization_code", code, redirect_uri }

Säkerhet

Lägg aldrig nycklar i klientkod. Använd server-side-anrop och rotera nycklar om du misstänker läcka.