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 24 ore e vanno rinnovati facendo login di nuovo. Includi il token in ogni richiesta: Authorization: Bearer <tuo-token>. I Comandi Rapidi di Apple e altri strumenti di automazione possono usare un header X-Api-Key a lungo termine (crea la chiave in Impostazioni → API Sviluppatori, prefisso sg_, hashata SHA-256 lato server, massimo 5 per utente).
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, briefing autopilot) condividono un limite giornaliero: 500 chiamate/giorno per account registrati. I limiti si resettano a mezzanotte UTC. Limiti a finestra scorrevole si applicano anche a login (5/15 min per email), upload (10/ora), anteprima upload (30/ora) e banking (20/ora). Controlla l'utilizzo AI 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.itEndpoint API sviluppatori
| Metodo | Percorso | Descrizione |
|---|---|---|
| GET | /api/v1/profile | Profilo utente autenticato: id, email, display_name, plan, created_at |
| GET | /api/v1/subscriptions | Lista abbonamenti (paginata). Filtri: ?category=&date_from=&date_to= |
| GET | /api/v1/subscriptions/:id | Dettaglio singolo abbonamento per ID |
| GET | /api/v1/budgets | Lista budget con buste e riepiloghi di spesa (paginata) |
| GET | /api/v1/assets | Lista asset di investimento con calcoli guadagno/perdita (paginata) |
| GET | /api/v1/net-worth | Riepilogo patrimonio netto: asset totali, guadagni, burn abbonamenti, fondi pensione |
| GET | /api/v1/analytics/spending-by-category | Ripartizione spesa per categoria per la sessione corrente |
| GET | /autopilot/briefing | Briefing AI consolidato: anomalie, stato budget, rinnovi, rischio scoperto, opportunità di risparmio |
| POST | /shortcut/log | Registra un pagamento con carta da Apple Shortcuts / IFTTT / Tasker. Corpo JSON con chiave API inclusa (nessuna intestazione necessaria). Supporta anche GET con query params. |
| GET | /ai-usage | Conteggio giornaliero delle chiamate AI e quota residua per la sessione autenticata |
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.it/api/v1/subscriptions \
-H "Authorization: Bearer eyJ..." \
-H "Content-Type: application/json"
# With filters
curl "https://api.spendguard.it/api/v1/subscriptions?category=Streaming&date_from=2026-01-01" \
-H "Authorization: Bearer eyJ..."