Wallet REST API

Accesso diretto ai tuoi dati finanziari

Integra i tuoi dati Wallet con Excel, Power BI, applicazioni personalizzate e strumenti di automazione usando la nostra REST API sicura.

RESTful
Bearer Token
JSON
Wallet REST API
GET
https://rest.budgetbakers.com/wallet
/v1/api/records
Response:
{
"records": [
{
"id": "a1b2c3d4",
"amount": -42.50,
"recordDate": "2025-10-20",
"category": "Groceries",
"payee": "Whole Foods"
}
]
}

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 Wallet e genera il tuo token API personale. Conservalo al sicuro — concede l'accesso ai tuoi dati.

3

Fai la tua prima richiesta

Usa l'URL base e il tuo token per iniziare a interrogare i tuoi dati finanziari. Guarda l'esempio a destra.

Dati disponibili

Accedi a tutti i tuoi dati finanziari tramite 10 endpoint dedicati.

Dati finanziari principali

GET/v1/api/records

Records

Transazioni con filtro per data, importo, categoria

GET/v1/api/accounts

Accounts

Conti bancari, carte di credito, investimenti

GET/v1/api/categories

Categories

Categorie delle transazioni

Pianificazione e obiettivi

GET/v1/api/budgets

Budgets

Definizioni e monitoraggio dei budget

GET/v1/api/goals

Goals

Obiettivi di risparmio e progressi

GET/v1/api/standing-orders

Standing Orders

Transazioni ricorrenti e abbonamenti

Organizzazione e strumenti

GET/v1/api/labels

Labels

Etichette e tag delle transazioni

GET/v1/api/record-rules

Record Rules

Regole di categorizzazione automatica

GET/v1/api/records/by-id

Records by ID

Cerca transazioni specifiche per ID

Monitoraggio

GET/v1/api/api-usage/stats

API Usage Stats

Monitora l'utilizzo dell'API e la quota rimanente

Riferimento API completo

Concetti chiave

Paginazione

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

  • limit — da 1 a 100 risultati per richiesta
  • offset — salta N risultati
  • nextOffset — restituito nella risposta per una paginazione semplice

Filtro

Usa prefissi tipizzati per filtrare i dati con precisione.

  • eq., contains., contains-i. — corrispondenza testo
  • gt., gte., lt., lte. — confronti di intervallo
  • Combina più filtri su qualsiasi campo

Limiti e intestazioni

Algoritmo token bucket con intestazioni HTTP chiare.

  • 500 richieste all'ora per token
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • Intestazione Retry-After in caso di limitazione

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=10" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

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']:
    print(f"{rec['recordDate']}: {rec['payee']} — {rec['amount']}")

Pronto per iniziare?

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

Esploratore API interattivoProva l'integrazione MCP