API לרישום חשבונאי מרחוק

התחבר כ-admin, פתח הגדרות → 🔑 API לרישום חשבונאי מרחוק ולחץ "צור טוקן".

הטוקן בטקסט גלוי מוצג פעם אחת בלבד — העתק מיד. השרת שומר רק את ה-hash מסוג SHA-256, ולכן ניתן להחליף טוקן אבוד רק באמצעות החלפה (שמבטלת את הישן).

פורמט הטוקן: bb_<userId>_<secret>. שלח בכל בקשה בתור Authorization: Bearer <token>.

גוף הבקשה הוא אובייקט JSON עם השדות הבאים:

• title (string, חובה) — שם העסקה
• amount (number, חובה) — חייב להיות חיובי
• type (string, אופציונלי, ברירת מחדל expense) — אחד מ-expense / income / prepaid_expense / pending_income
• category (string, אופציונלי) — שם הקטגוריה
• note (string, אופציונלי) — הערה חופשית
• created_at (string, אופציונלי) — ISO 8601; ברירת המחדל היא עכשיו

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

מחזיר את שמות הקטגוריות של ה-admin בסדר הרשימה הנפתחת בלוח הבקרה. התגובה מכילה רק שמות — ללא ids, user ids או נתוני עסקה.

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

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

מחזיר את תחיליות התגיות שעודכנו לאחרונה (סימני #XXX המוטמעים בכותרות). ברירת מחדל 20; השתמש ב-?limit= כדי לעקוף (מקסימום 100).

מחזיר מערך ריק במקום שגיאה אם הטבלה tag_prefixes עדיין לא קיימת.

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

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

כל השגיאות הן בפורמט JSON: { "error": "הודעה" }.

• 401 — חסר אישור, פורמט טוקן שגוי, בוטל או לא תואם
• 402 — תוקף המנוי פג; חידוש נדרש לכתיבה
• 405 — שיטה לא נתמכת (למשל GET על /api/ingest)
• 501 — לשרת חסר SUPABASE_SERVICE_ROLE_KEY
• 500 — שגיאה פנימית אחרת

מתכנן, הטוקן יכול לכתוב רק לארגון שלו — לא יכול להתחזות ל-orgs אחרים או לקרוא נתונים קיימים:

• user_id תמיד שייך לבעל הטוקן; לא ניתן לזייף
• org_id תמיד שייך ל-org של הבעלים; כתיבה בין orgs היא בלתי אפשרית
• טוקנים מונפקים רק לתפקיד admin (manager / staff מקבלים 403)
• התגובות לא חושפות שורות אחרות — רק { id, created_at } מוחזר
• הביטול מיידי; ניתן לסובב בכל עת מההגדרות

הוסף פעולת "Get Contents of URL", URL https://billbook.me/api/ingest, שיטה POST, כותרות Authorization: Bearer bb_... ו-Content-Type: application/json, וגוף JSON: {"title":"קפה","amount":120,"type":"expense"}. חבר את title ו-amount לקלט הקיצור או למשתני "שאל בכל פעם".