Riferimento API

Autenticazione

Tutti gli endpoint /api/v1/* richiedono un token JWT Bearer. Ottieni un token chiamando POST /auth/login con email e password. I token scadono dopo 72 ore. Includi il token in ogni richiesta: Authorization: Bearer <tuo-token>

POST /auth/login
Content-Type: application/json

{ "email": "you@example.com", "password": "yourpassword" }

# Response:
{ "access_token": "eyJ...", "token_type": "bearer" }

Limiti di chiamate

Gli endpoint basati sull'AI (consigli risparmio, script negoziazione, insight quotidiano, chat, email cancellazione, suggerimenti obiettivi, strategia debiti) condividono un limite giornaliero: 200 chiamate/giorno per sessioni anonime, 500 chiamate/giorno per account registrati. I limiti si resettano a mezzanotte UTC. Controlla l'utilizzo attuale con GET /ai-usage.

URL base

SpendGuard offre un'API REST di sola lettura per sviluppatori. Autenticati con il tuo token JWT per accedere a dati di abbonamenti, budget, asset e analisi in modo programmatico.

https://api.spendguard.app

Endpoint API sviluppatori

MetodoPercorsoDescrizione
GET/api/v1/profileProfilo utente autenticato: id, email, display_name, created_at
GET/api/v1/subscriptionsLista abbonamenti. Filtri: ?category=&date_from=&date_to=
GET/api/v1/subscriptions/:idDettaglio singolo abbonamento per ID
GET/api/v1/budgetsLista budget con buste e riepilogi di spesa
GET/api/v1/assetsLista asset di investimento con calcoli guadagno/perdita
GET/api/v1/net-worthRiepilogo patrimonio netto: asset totali, guadagni, burn abbonamenti
GET/api/v1/analytics/spending-by-categoryRipartizione spesa per categoria per la sessione corrente

Formato risposta

Tutti gli endpoint /api/v1/* racchiudono la risposta in un envelope standard:

{
  "data": { ... },
  "meta": {
    "timestamp": "2026-03-29T12:00:00Z"
  }
}

Esempio di richiesta

# Get your subscriptions
curl -X GET https://api.spendguard.io/api/v1/subscriptions \
  -H "Authorization: Bearer eyJ..." \
  -H "Content-Type: application/json"

# With filters
curl "https://api.spendguard.io/api/v1/subscriptions?category=Streaming&date_from=2026-01-01" \
  -H "Authorization: Bearer eyJ..."