Snabbstart
Från registrerad klient till ditt första anrop mot Klirrs API.
Den här guiden tar dig till ett första lyckat anrop: en lista över organisationens kunder. Har du redan en registrerad klient tar det ett par minuter.
En klient måste registreras av Klirr först
Det finns inga API-nycklar och ingen självbetjäning för integrationer. Klirr registrerar varje klient och lämnar ut client_id och client_secret. Hemligheten visas en gång och lagras bara som hash hos Klirr. Kontakta Klirr på [email protected] och ange integrationens namn, din redirect-URI och vilka scopes du behöver.
Du behöver också en Klirr-användare i en organisation med Kräver AI Pro.
Skicka användaren till godkännandet
Öppna den här URL:en i webbläsaren. Byt ut värdena inom <>:
https://app.klirr.ai/api/v1/oauth-v1/auth?response_type=code&client_id=<client_id>&redirect_uri=<redirect_uri>&scope=customer&state=<slumpad_sträng>Användaren loggar in, väljer organisation och godkänner. Klirr skickar sedan webbläsaren till din redirect-URI med ?code=...&state=.... Koden gäller i 10 minuter.
Växla koden mot tokens
curl -X POST https://app.klirr.ai/api/v1/oauth-v1/token \
-u "<client_id>:<client_secret>" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d grant_type=authorization_code \
-d code=<code> \
--data-urlencode redirect_uri=<redirect_uri>{
"access_token": "<access_token>",
"refresh_token": "<refresh_token>",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "customer"
}Gör ditt första anrop
curl https://app.klirr.ai/api/v1/3/customers \
-H "Authorization: Bearer <access_token>"{
"Customers": [
{
"@url": "https://app.klirr.ai/api/v1/3/customers/1001",
"Address1": "Storgatan 1",
"Address2": "",
"City": "Uppsala",
"CustomerNumber": "1001",
"Email": "[email protected]",
"Name": "Bergström Bygg AB",
"OrganisationNumber": "556000-0000",
"Phone": "",
"ZipCode": "753 20"
}
],
"MetaInformation": { "@TotalResources": 1, "@TotalPages": 1, "@CurrentPage": 1 }
}Nästa steg
- Autentisering: förnyelse av tokens, PKCE och återkallning.
- Fortnox-kompatibilitet: kuvert, partiella uppdateringar och taltyper.
- Skapa och skicka en faktura.