API de Contabilitate la Distanță

Autentifică-te ca admin, deschide Setări → 🔑 API de Contabilitate la Distanță și apasă pe „Generează token".

Tokenul în text simplu este afișat o singură dată — copiază-l imediat. Serverul stochează doar hash-ul SHA-256, deci un token pierdut poate fi înlocuit doar prin rotire (care îl invalidează pe cel vechi).

Format token: bb_<userId>_<secret>. Trimite-l la fiecare cerere ca Authorization: Bearer <token>.

Corpul cererii este un obiect JSON cu aceste câmpuri:

• title (string, obligatoriu) — numele tranzacției
• amount (number, obligatoriu) — trebuie să fie pozitiv
• type (string, opțional, implicit expense) — unul dintre expense / income / prepaid_expense / pending_income
• category (string, opțional) — numele categoriei
• note (string, opțional) — notă liberă
• created_at (string, opțional) — ISO 8601; implicit acum

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": "..." }

Returnează numele categoriilor adminului în ordinea din meniul derulant al panoului. Răspunsul conține doar numele — fără ids, user ids sau date despre tranzacții.

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

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

Returnează prefixele de etichetă cel mai recent actualizate (marcajele #XXX încorporate în titluri). Implicit 20; folosește ?limit= pentru a modifica (max. 100).

Returnează un array gol în loc de o eroare dacă tabelul tag_prefixes încă nu există.

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

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

Toate erorile sunt JSON: { "error": "mesaj" }.

• 401 — autorizare lipsă, token malformat, revocat sau nepotrivit
• 402 — abonament expirat; reînnoirea este necesară pentru a scrie
• 405 — metodă nesuportată (de ex. GET pe /api/ingest)
• 501 — serverului îi lipsește SUPABASE_SERVICE_ROLE_KEY
• 500 — altă eroare internă

Prin design, tokenul poate scrie doar în propria organizație — nu poate impersona alte orgs și nu poate citi date existente:

• user_id este întotdeauna proprietarul tokenului; nu poate fi falsificat
• org_id este întotdeauna org-ul proprietarului; scrierile între orgs sunt imposibile
• Tokenurile se emit doar rolului admin (manager / staff primesc 403)
• Răspunsurile nu dezvăluie niciodată alte rânduri — se returnează doar { id, created_at }
• Revocarea este imediată; rotește oricând din Setări

Adaugă o acțiune „Obține conținutul unui URL", URL https://billbook.me/api/ingest, metodă POST, anteturi Authorization: Bearer bb_... și Content-Type: application/json, iar corpul cererii ca JSON: {"title":"Cafea","amount":120,"type":"expense"}. Conectează title și amount la intrarea Scurtăturii sau la variabile „Întreabă de fiecare dată".