AI Budget API voor ontwikkelaars

AI Budget heeft een publieke REST API met OAuth 2.0-autorisatie: ‘Koppelen met AI Budget’. Met toestemming van de gebruiker kan je app diens uitgaven lezen en schrijven en bonnetjes en categorieën ophalen. De gebruiker kiest zelf wat er gedeeld wordt en kan de toegang altijd intrekken.

API-referentie App registreren Hoe we het bouwden

Wat de API nu al kan

Uitgaven lezen, aanmaken, wijzigen en verwijderen (/public/v1/expenses).
Synchroniseren via de wijzigingenfeed /public/v1/expenses/changes: vraag hem regelmatig op en ontvang nieuwe, gewijzigde en verwijderde uitgaven – verwijderingen komen binnen als delete-items (tombstones).
De bonnetjesfoto’s downloaden die aan uitgaven hangen.
De uitgavencategorieën van de rekening lezen.
Meerdere rekeningen in één koppeling: de gebruiker vinkt de rekeningen aan die gedeeld worden (persoonlijk, zakelijk, gezin…) en elk verzoek noemt zijn rekening in de header X-Account-Id. GET /public/v1/accounts toont de gedeelde rekeningen met hun type.
Inkomsten lezen, toevoegen, wijzigen en verwijderen (/public/v1/incomes), met een eigen wijzigingsfeed; inkomsten uit een overboeking tussen rekeningen zijn alleen-lezen.
Budgetten lezen met de voortgang van de huidige periode, en ze aanmaken, wijzigen en verwijderen (/public/v1/budgets).
Totalen voor analyses lezen (/public/v1/analytics/summary, by-category, monthly), omgerekend naar de weergavevaluta van de gebruiker.
Rechten (scopes): expenses:read, expenses:write, receipts:read, categories:read, incomes:read, incomes:write, budgets:read, budgets:write, analytics:read.

Voorlopig dekt de API uitgaven, bonnetjes, categorieën, inkomsten, budgetten en analysetotalen. Doelen en andere resources kunnen later volgen.

Gratis en zonder beoordeling

Toegang tot de API is gratis. Elke ontwikkelaar registreert zelf een app in AI Budget (Instellingen → Ontwikkelaars) – zonder handmatige beoordeling en zonder wachten. Limieten gelden per koppeling en per app.

Privacy van de gebruiker

De gebruiker bepaalt welke rekeningen gedeeld worden en kan je app altijd ontkoppelen via Instellingen → Gekoppelde apps (zo werkt het). End-to-end versleutelde rekeningen blijven beschermd: een rekening met tekstversleuteling is alleen-lezen te koppelen en een volledig versleutelde rekening kan niet worden gekoppeld.

Starten in 3 stappen

Registreer een app via Instellingen → Ontwikkelaars: geef een naam en een redirect-URI op, en je krijgt een client_id en client_secret.
Stuur de gebruiker naar de autorisatie-URL https://app.ai-budget.pl/authorize met PKCE. De gebruiker logt in, vinkt de rekeningen aan en keurt de rechten goed.
Wissel de code in voor een token via POST /oauth/token en roep https://api.ai-budget.pl/public/v1 aan met de header Authorization: Bearer ….

# 1. Send the user to the consent page (PKCE S256)
https://app.ai-budget.pl/authorize?response_type=code&client_id=aba_ci_...
  &redirect_uri=https%3A%2F%2Fexample.com%2Fcallback
  &scope=expenses%3Aread+categories%3Aread&state=...
  &code_challenge=...&code_challenge_method=S256

# 2. Exchange the code for tokens
curl -X POST https://api.ai-budget.pl/oauth/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=authorization_code -d code="$CODE" \
  -d redirect_uri=https://example.com/callback -d code_verifier="$CODE_VERIFIER"

# 3. Call the API for one of the connected accounts
curl https://api.ai-budget.pl/public/v1/accounts -H "Authorization: Bearer $ACCESS_TOKEN"
curl https://api.ai-budget.pl/public/v1/expenses -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Account-Id: $ACCOUNT_ID"

Eerste integratie: eKsięgowy AI

eKsięgowy AI koppelt via de API de zakelijke en de privérekening van een gebruiker en houdt ze strikt gescheiden.

Documentatie

Alle endpoints (Swagger) met een stapsgewijze handleiding:

API-referentie App registreren Hoe we het bouwden

English · Polski · Русский · OpenAPI-schema (JSON)