Wallet REST API

קראו ונהלו את הנתונים הפיננסיים שלכם

קראו ונהלו את נתוני Wallet — עסקאות, חשבונות, תקציבים ועוד — מ-Excel, ‏Power BI, סקריפטים וכלי אוטומציה דרך REST API מאובטח.

הפניית API מלאהOpenAPI spec
Wallet REST API
GET
https://rest.budgetbakers.com/wallet
/v1/api/records?limit=30
Response:
{
"records": [
{
"id": "3643bf2e-…",
"counterParty": "Billa",
"amount": { "value": -612, "currencyCode": "CZK" },
"recordDate": "2026-06-09T11:09:00Z",
"category": { "name": "Groceries", … },
"recordType": "expense",
"paymentType": "debit_card"
}, …
]
}

תחילת העבודה

1

השג Wallet Premium

REST API זמין למנויי Wallet Premium. שדרג את החשבון שלך כדי לפתוח גישה ל-API.

2

צור טוקן API

עברו אל הגדרות באפליקציית הווב של Wallet וצרו אסימון API אישי. שמרו עליו — הוא מעניק גישה לנתונים שלכם.

3

בצע את הבקשה הראשונה

השתמשו בכתובת הבסיס ובאסימון שלכם כדי להתחיל לשאול את הנתונים הפיננסיים — נסו זאת בשידור חי בסייר ה-API האינטראקטיבי.

נתונים זמינים

גישת קריאה מלאה להכול — ויצירה, עדכון ומחיקה היכן שזה חשוב.

נתונים פיננסיים בסיסיים

GETPOSTPATCH/v1/api/records

Records

עסקאות עם סינון עשיר — צרו עד 20 ועדכנו עד 10 בבקשה אחת

GETPOSTPATCH/v1/api/accounts

Accounts

חשבונות בנק, כרטיסים ומזומן — הצגה, פתיחת חדשים, שינוי שם ועדכון

GETPOSTPATCH/v1/api/categories

Categories

עץ הקטגוריות — הוסיפו תת-קטגוריות מותאמות ושנו שמות משלכם

תכנון וארגון

GETPOSTPATCH/v1/api/budgets

Budgets

הגדרות תקציב ומעקב — צרו והתאימו אותם

GET/v1/api/goals

Goals

יעדי חיסכון והתקדמות

GET/v1/api/standing-orders

Standing Orders

תשלומים חוזרים — ‎/items מציג את המופעים שנוצרו

GETPOSTPATCH/v1/api/labels

Labels

תוויות עסקאות — הצגה, יצירה, שינוי שם וצבע

GET/v1/api/record-rules

Record Rules

כללי קטגוריזציה אוטומטית

תחזוקה וניטור

GET/v1/api/{type}/references

Entity References

חיפוש אצווה של ישויות קשורות — בדיקה בטוחה לפני מחיקה

DELETE/v1/api/{type}

Delete Entities

מחקו עד 10 רשומות, תקציבים, חשבונות, תוויות ועוד בבקשה אחת

GET/v1/api/api-usage/stats

API Usage Stats

עקבו אחר השימוש ב-API והמכסה שנותרה

מושגים מרכזיים

עימוד

שלוט בערכות התוצאות עם פרמטרי limit ו-offset.

  • limit — עד 200 תוצאות בבקשה (ברירת מחדל 30)
  • offset — דילוג על N תוצאות
  • nextOffset — מוחזר כשקיימות תוצאות נוספות

סינון

השתמש בקידומות מוקלדות לסינון מדויק של נתונים.

  • eq., contains., contains-i. — סינון טקסט
  • gt., gte., lt., lte. — השוואות טווח
  • חזרו על פילטר (עד פעמיים) לטווחי AND

מגבלות וכותרות

הגבלת token-bucket המאפשרת פרצי בקשות קצרים, עם כותרות HTTP ברורות.

  • 300 בקשות לשעה ללקוח
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • 429 + Retry-After בחריגה

כתיבה באצוות

כתבו באצוות קטנות וצפויות — הפריטים מעובדים באופן עצמאי.

  • POST /records — עד 20 פריטים
  • PATCH — עד 10 פריטים
  • DELETE — עד 10 מזהים

טוב לדעת

המרת מטבע

ה-REST API משתמש אוטומטית בשערי מטבע היסטוריים לפעולות בין מטבעות. ההמרה פועלת בגישת best-effort — השערים מגיעים מנתוני שוק ציבוריים ועשויים להיות שונים מעט משערי בנקים או חלפנים.

סכומים ומיון

withTotal=true מחזיר את מספר ההתאמות הכולל לצד העמוד; sortBy ממיין לפי כל שדה נתמך (+ עולה, - יורד).

סטטוס סנכרון

טוקן ה-API הראשון מפעיל סנכרון ראשוני (בקשות מחזירות 409 עד לסיומו). לאחר מכן הכותרות X-Last-Data-Change-At ו-X-Sync-In-Progress מציינות עד כמה הנתונים טריים.

הצלחה חלקית (HTTP 207)

פריטי אצווה מעובדים באופן עצמאי — תוצאות מעורבות מחזירות סיכום לכל פריט. הוסיפו validation=strict כדי להיכשל מהר במקום.

דוגמאות אינטגרציה

curl

הדרך הפשוטה ביותר לבדוק את ה-API מהטרמינל.

curl -X GET "https://rest.budgetbakers.com/wallet/v1/api/records?limit=30" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Excel דרך Power Query

ייבא עסקאות ישירות ל-Excel לניתוח ודוחות מותאמים אישית.

  1. 1.פתח Excel → נתונים → קבל נתונים → מהאינטרנט
  2. 2.הזן: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.הוסף כותרת Authorization עם ה-Bearer token שלך
  4. 4.המר וטען נתונים לגיליון האלקטרוני שלך

Power BI Dashboard

צור לוחות מחוונים פיננסיים בזמן אמת עם רענון נתונים אוטומטי.

  1. 1.השתמש במחבר Web ב-Power BI Desktop
  2. 2.URL: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.הגדר אימות Bearer token
  4. 4.הגדר רענון מתוזמן ובנה תצוגות חזותיות

ניתוח Python

נתח את הנתונים הפיננסיים שלך באופן תכנותי עם Python.

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}
params = {
    'recordDate': 'gte.2025-01-01',
    'limit': 100
}

response = requests.get(
    'https://rest.budgetbakers.com/wallet/v1/api/records',
    headers=headers,
    params=params
)

data = response.json()
for rec in data['records']:
    amount = rec['amount']
    print(f"{rec['recordDate'][:10]} {rec['counterParty']}: "
          f"{amount['value']} {amount['currencyCode']}")

מוכן להתחיל?

חקור את הפניית ה-API המלאה עם תיעוד אינטראקטיבי, דוגמאות בקשות וסכמות תגובה.

סייר API אינטראקטיבינסה אינטגרציית MCP