API voor Boekhouden op Afstand

Log in als admin, open Instellingen → 🔑 API voor Boekhouden op Afstand en klik op "Token genereren".

Het tekst-token wordt slechts één keer getoond — kopieer het direct. De server bewaart alleen de SHA-256-hash; een verloren token kun je alleen vervangen door te roteren (wat het oude ongeldig maakt).

Token-formaat: bb_<userId>_<secret>. Stuur het bij elk verzoek als Authorization: Bearer <token>.

De request body is een JSON-object met deze velden:

• title (string, vereist) — naam van de transactie
• amount (number, vereist) — moet positief zijn
• type (string, optioneel, standaard expense) — een van expense / income / prepaid_expense / pending_income
• category (string, optioneel) — categorienaam
• note (string, optioneel) — vrije notitie
• created_at (string, optioneel) — ISO 8601; standaard nu

curl -X POST https://billbook.me/api/ingest \
  -H "Authorization: Bearer bb_<userId>_<secret>" \
  -H "Content-Type: application/json" \
  -d '{"title":"Coffee","amount":120,"type":"expense","category":"Food"}'

# response: 201
{ "id": "...", "created_at": "..." }

Geeft de categorienamen van de admin terug in de volgorde van het dashboard-dropdown. Het antwoord bevat alleen namen — geen ids, user ids of transactiegegevens.

curl https://billbook.me/api/ingest/categories \
  -H "Authorization: Bearer bb_<userId>_<secret>"

# response: 200
{ "categories": ["Food", "Rent", "..."] }

Geeft de meest recent bijgewerkte tagvoorvoegsels terug (de #XXX-markeringen in titels). Standaard 20; gebruik ?limit= om te overschrijven (max. 100).

Geeft een lege array terug in plaats van een fout als de tabel tag_prefixes nog niet bestaat.

curl "https://billbook.me/api/ingest/tags?limit=20" \
  -H "Authorization: Bearer bb_<userId>_<secret>"

# response: 200
{ "tags": ["#management-fee", "#travel", "..."] }

Alle fouten zijn JSON: { "error": "bericht" }.

• 401 — autorisatie ontbreekt, foutief token-formaat, ingetrokken of niet overeenkomend
• 402 — abonnement verlopen; vernieuwing vereist om te schrijven
• 405 — methode niet ondersteund (bijv. GET op /api/ingest)
• 501 — SUPABASE_SERVICE_ROLE_KEY ontbreekt op de server
• 500 — andere interne fout

Door de opzet kan het token alleen schrijven binnen de eigen organisatie — geen impersonatie van andere orgs of lezen van bestaande gegevens:

• user_id is altijd de eigenaar van het token; niet vervalsbaar
• org_id is altijd de org van de eigenaar; cross-org schrijven is onmogelijk
• Tokens worden alleen uitgegeven aan de admin-rol (manager / staff krijgen 403)
• Antwoorden lekken nooit andere rijen — alleen { id, created_at } wordt geretourneerd
• Intrekken is onmiddellijk; roteer wanneer je wilt vanuit Instellingen

Voeg een "URL-inhoud ophalen"-actie toe, URL https://billbook.me/api/ingest, methode POST, headers Authorization: Bearer bb_... en Content-Type: application/json, en request body als JSON: {"title":"Koffie","amount":120,"type":"expense"}. Koppel title en amount aan invoer van de Opdracht of "Vraag elke keer"-variabelen.