Wallet REST API

Čtěte a spravujte svá finanční data

Čtěte a spravujte data ve Wallet – transakce, účty, rozpočty a další – z Excelu, Power BI, skriptů a automatizačních nástrojů přes zabezpečené REST API.

Kompletní API referenceOpenAPI 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"
}, …
]
}

Začínáme

1

Pořiďte si Wallet Premium

REST API je dostupné pro předplatitele Wallet Premium. Upgradujte svůj účet pro přístup k API.

2

Vygenerujte API token

V Nastavení webové aplikace Wallet vygenerujte svůj osobní API token. Uchovejte ho v bezpečí – zpřístupňuje vaše data.

3

Odešlete první požadavek

Pomocí základní URL a svého tokenu začněte dotazovat svá finanční data – vyzkoušejte si to naživo v interaktivním API průzkumníku.

Dostupná data

Plný přístup ke čtení všeho – a vytváření, úpravy a mazání tam, kde na tom záleží.

Základní finanční data

GETPOSTPATCH/v1/api/records

Records

Transakce s bohatým filtrováním – vytvořte až 20 a upravte až 10 v jednom požadavku

GETPOSTPATCH/v1/api/accounts

Accounts

Bankovní účty, karty a hotovost – vypisujte je, zakládejte nové, přejmenovávejte a upravujte

GETPOSTPATCH/v1/api/categories

Categories

Strom kategorií – přidávejte vlastní podkategorie a přejmenovávejte ty své

Plánování a organizace

GETPOSTPATCH/v1/api/budgets

Budgets

Definice rozpočtů a jejich sledování – vytvářejte a upravujte je

GET/v1/api/goals

Goals

Spořicí cíle a jejich průběh

GET/v1/api/standing-orders

Standing Orders

Opakované platby – /items vypíše vygenerované výskyty

GETPOSTPATCH/v1/api/labels

Labels

Štítky transakcí – vypisujte, vytvářejte, přejmenovávejte a měňte barvy

GET/v1/api/record-rules

Record Rules

Pravidla automatické kategorizace

Údržba a monitoring

GET/v1/api/{type}/references

Entity References

Hromadné vyhledání souvisejících entit – bezpečná kontrola před mazáním

DELETE/v1/api/{type}

Delete Entities

Smažte až 10 záznamů, rozpočtů, účtů, štítků a dalších v jednom požadavku

GET/v1/api/api-usage/stats

API Usage Stats

Sledujte využití API a zbývající kvótu

Klíčové koncepty

Stránkování

Ovládejte velikost výsledků pomocí parametrů limit a offset.

  • limit – až 200 výsledků na požadavek (výchozí 30)
  • offset – přeskočí N výsledků
  • nextOffset – vrací se, když existují další výsledky

Filtrování

Používejte typované prefixy pro přesné filtrování dat.

  • eq., contains., contains-i. – textové filtry
  • gt., gte., lt., lte. – rozsahová porovnání
  • Filtr lze zopakovat (max 2×) pro AND rozsahy

Limity a hlavičky

Token-bucket limitování umožňující krátké špičky, s přehlednými HTTP hlavičkami.

  • 300 požadavků za hodinu na klienta
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • 429 + Retry-After při překročení

Dávkové zápisy

Zapisujte v malých, předvídatelných dávkách – položky se zpracovávají nezávisle.

  • POST /records — až 20 položek
  • PATCH — až 10 položek
  • DELETE — až 10 ID

Dobré vědět

Převod měn

REST API automaticky využívá historické směnné kurzy pro operace napříč měnami. Převod funguje na principu best-effort – kurzy pocházejí z veřejných tržních dat a mohou se mírně lišit od kurzů bank či směnáren.

Součty a řazení

withTotal=true vrátí vedle stránky i celkový počet shod; sortBy řadí výsledky podle libovolného podporovaného pole (+ vzestupně, - sestupně).

Stav synchronizace

První API token spustí úvodní synchronizaci dat (požadavky vrací 409, dokud neskončí). Poté hlavičky X-Last-Data-Change-At a X-Sync-In-Progress říkají, jak čerstvá data jsou.

Částečný úspěch (HTTP 207)

Položky dávky se zpracovávají nezávisle – smíšené výsledky vrací přehled po jednotlivých položkách. S validation=strict požadavek místo toho rychle selže celý.

Příklady integrace

curl

Nejjednodušší způsob, jak otestovat API z terminálu.

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

Excel přes Power Query

Importujte transakce přímo do Excelu pro vlastní analýzu a reportování.

  1. 1.Otevřete Excel → Data → Načíst data → Z webu
  2. 2.Zadejte: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Přidejte hlavičku Authorization s vaším Bearer tokenem
  4. 4.Transformujte a načtěte data do tabulky

Power BI Dashboard

Vytvořte finanční dashboardy v reálném čase s automatickou aktualizací dat.

  1. 1.Použijte Web konektor v Power BI Desktop
  2. 2.URL: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Nakonfigurujte Bearer token autentizaci
  4. 4.Nastavte plánovanou aktualizaci a vytvořte vizualizace

Analýza v Pythonu

Analyzujte finanční data programaticky pomocí Pythonu.

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']}")

Připraveni začít?

Prozkoumejte kompletní API referenci s interaktivní dokumentací, příklady požadavků a schématy odpovědí.

Interaktivní API prohlížečVyzkoušet MCP integraci