API Finance.HDdev
Integra Finance.HDdev nei tuoi strumenti. Accedi ai tuoi conti, transazioni, budget e categorie tramite un'API REST semplice e sicura.
Autenticazione
Bearer token (JWT). Ottieni il tuo token dall'area personale nelle impostazioni del tuo account.
URL di base
Tutte le richieste utilizzano il seguente URL di base:
https://finance.hddev.eu/api/v1Formato
Tutte le richieste e risposte utilizzano il formato JSON. Header richiesto: Content-Type: application/json
Esempio di autenticazione
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Endpoint disponibili
Panoramica dei principali endpoint dell'API Finance.HDdev.
/api/v1/accountsElenco dei conti bancari connessi con saldi e metadati.
/api/v1/transactionsElenco delle transazioni con filtri (data, categoria, importo, conto).
/api/v1/budgetsBudget e obiettivi con progressi attuali.
/api/v1/transactionsCrea una transazione manuale (spesa, entrata o bonifico).
/api/v1/categoriesCategorie disponibili (di sistema e personalizzate).
Limiti di frequenza
Le richieste API sono soggette a limiti di frequenza per garantire la stabilità del servizio.
Documentazione completa
La documentazione interattiva completa (OpenAPI / Swagger) sarà disponibile a breve. Includerà gli schemi delle richieste e risposte, i codici di errore e degli esempi dettagliati.
Sicurezza
Tutte le comunicazioni sono crittografate tramite HTTPS/TLS. I token JWT scadono dopo 30 minuti (rinnovo automatico tramite refresh token). L'API è conforme al GDPR e non restituisce mai credenziali bancarie.
Serve aiuto con l'API?
Il nostro team tecnico è a disposizione per assisterti nell'integrazione dell'API Finance.HDdev nei tuoi strumenti e workflow.
Contatta il team APIapi@hddev.eu
Principi di Architettura e Utilizzo
L'API di Finance.HDdev si basa su un'architettura RESTful, che la rende prevedibile e facile da usare. Tutte le richieste vengono effettuate tramite HTTPS per garantire la riservatezza dei dati scambiati. Le risposte, così come i corpi delle richieste POST e PUT, sono sistematicamente formattati in JSON. La struttura degli URL è orientata alle risorse, permettendoti di interagire in modo intuitivo con i diversi oggetti del nostro sistema, come conti, transazioni o budget. Applichiamo un sistema di limitazione delle richieste (rate limiting) per garantire la stabilità della piattaforma per tutti i nostri utenti. I dettagli di questi limiti sono specificati nell'header di ogni risposta.
Endpoint Principali e Casi d'Uso
La nostra API espone diversi endpoint per coprire l'insieme delle funzionalità di gestione finanziaria. L'endpoint `/transactions` ti permette di elencare, filtrare e recuperare i dettagli di ogni transazione, ideale per analisi approfondite delle spese. Con `/accounts`, puoi ottenere l'elenco dei tuoi conti connessi e il loro saldo in tempo reale. Per il monitoraggio del budget, gli endpoint `/budgets` e `/categories` ti danno il controllo completo sulla creazione e il monitoraggio dei tuoi limiti di spesa. Infine, l'endpoint `/goals` ti permette di gestire i tuoi obiettivi di risparmio. Questi strumenti combinati aprono la strada a numerose applicazioni, dal semplice script di esportazione dati a un'applicazione mobile completa di coaching finanziario.
Autenticazione e Sicurezza dell'API
La sicurezza è la nostra priorità assoluta. L'accesso all'API è protetto da chiavi di autenticazione personali che puoi generare, gestire e revocare dalla tua dashboard utente. Ogni richiesta API deve includere la tua chiave API nell'header `Authorization` sotto forma di Bearer Token. È imperativo conservare queste chiavi segrete e non esporle mai lato client (nel codice JavaScript del browser, ad esempio). Tutte le connessioni all'API sono crittografate con TLS (SSL). Ti incoraggiamo inoltre a utilizzare i webhook per ricevere notifiche in tempo reale sugli eventi importanti, come una nuova transazione, anziché interrogare continuamente l'API, riducendo così il volume delle richieste e ottimizzando le prestazioni.