Wallet REST API

Leggi e gestisci i tuoi dati finanziari

Leggi e gestisci i tuoi dati Wallet — transazioni, conti, budget e altro — da Excel, Power BI, script e strumenti di automazione tramite un’API REST sicura.

Riferimento API completoOpenAPI 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"
}, …
]
}

Per iniziare

1

Ottieni Wallet Premium

La REST API è disponibile per gli abbonati Wallet Premium. Aggiorna il tuo account per sbloccare l'accesso all'API.

2

Genera il token API

Vai nelle Impostazioni dell’app web di Wallet e genera il tuo token API personale. Conservalo al sicuro: dà accesso ai tuoi dati.

3

Fai la tua prima richiesta

Usa l’URL di base e il tuo token per iniziare a interrogare i tuoi dati finanziari — provalo dal vivo nell’esploratore interattivo delle API.

Dati disponibili

Accesso completo in lettura a tutto — e creazione, aggiornamento ed eliminazione dove conta.

Dati finanziari principali

GETPOSTPATCH/v1/api/records

Records

Transazioni con filtri avanzati — crea fino a 20 e aggiorna fino a 10 per richiesta

GETPOSTPATCH/v1/api/accounts

Accounts

Conti bancari, carte e contanti — elencali, aprine di nuovi, rinomina e aggiorna

GETPOSTPATCH/v1/api/categories

Categories

L’albero delle categorie — aggiungi sottocategorie personalizzate e rinomina le tue

Pianificazione e organizzazione

GETPOSTPATCH/v1/api/budgets

Budgets

Definizioni e monitoraggio dei budget — creali e modificali

GET/v1/api/goals

Goals

Obiettivi di risparmio e progressi

GET/v1/api/standing-orders

Standing Orders

Pagamenti ricorrenti — /items elenca le occorrenze generate

GETPOSTPATCH/v1/api/labels

Labels

Etichette delle transazioni — elenca, crea, rinomina e ricolora

GET/v1/api/record-rules

Record Rules

Regole di categorizzazione automatica

Manutenzione e monitoraggio

GET/v1/api/{type}/references

Entity References

Ricerca in batch delle entità collegate — un controllo sicuro prima delle eliminazioni

DELETE/v1/api/{type}

Delete Entities

Elimina fino a 10 record, budget, conti, etichette e altro per richiesta

GET/v1/api/api-usage/stats

API Usage Stats

Monitora l’utilizzo dell’API e la quota rimanente

Concetti chiave

Paginazione

Controlla i set di risultati con i parametri limit e offset.

  • limit — fino a 200 risultati per richiesta (predefinito 30)
  • offset — salta N risultati
  • nextOffset — restituito quando esistono altri risultati

Filtro

Usa prefissi tipizzati per filtrare i dati con precisione.

  • eq., contains., contains-i. — filtri di testo
  • gt., gte., lt., lte. — confronti di intervallo
  • Ripeti un filtro (fino a 2×) per intervalli AND

Limiti e intestazioni

Limitazione token-bucket che consente brevi picchi, con header HTTP chiari.

  • 300 richieste all’ora per client
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • 429 + Retry-After in caso di superamento

Scritture in batch

Scrivi in batch piccoli e prevedibili — gli elementi vengono elaborati in modo indipendente.

  • POST /records — fino a 20 elementi
  • PATCH — fino a 10 elementi
  • DELETE — fino a 10 ID

Buono a sapersi

Conversione di valuta

L’API REST sfrutta automaticamente i tassi di cambio storici per le operazioni tra valute. La conversione segue un approccio best-effort: i tassi provengono da dati di mercato pubblici e possono differire leggermente da quelli bancari o dei cambiavalute.

Totali e ordinamento

withTotal=true restituisce il conteggio totale delle corrispondenze insieme alla pagina; sortBy ordina per qualsiasi campo supportato (+ crescente, - decrescente).

Stato di sincronizzazione

Il tuo primo token API avvia una sincronizzazione iniziale (le richieste restituiscono 409 finché non termina). Dopo, gli header X-Last-Data-Change-At e X-Sync-In-Progress indicano quanto sono aggiornati i dati.

Successo parziale (HTTP 207)

Gli elementi del batch vengono elaborati in modo indipendente — risultati misti restituiscono un riepilogo per elemento. Aggiungi validation=strict per fallire subito invece.

Esempi di integrazione

curl

Il modo più semplice per testare l'API dal terminale.

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

Excel tramite Power Query

Importa le transazioni direttamente in Excel per analisi e report personalizzati.

  1. 1.Apri Excel → Dati → Recupera dati → Dal web
  2. 2.Inserisci: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Aggiungi l'intestazione Authorization con il tuo Bearer token
  4. 4.Trasforma e carica i dati nel tuo foglio di calcolo

Power BI Dashboard

Crea dashboard finanziari in tempo reale con aggiornamento automatico dei dati.

  1. 1.Usa il connettore Web in Power BI Desktop
  2. 2.URL: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Configura l'autenticazione Bearer token
  4. 4.Imposta l'aggiornamento pianificato e crea visualizzazioni

Analisi Python

Analizza i tuoi dati finanziari in modo programmatico con 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']}")

Pronto per iniziare?

Esplora il riferimento API completo con documentazione interattiva, esempi di richieste e schemi di risposta.

Esploratore API interattivoProva l'integrazione MCP