API Finance.HDdev
Integrez Finance.HDdev dans vos outils. Accedez a vos comptes, transactions, budgets et categories via une API REST simple et securisee.
Authentification
Bearer token (JWT). Obtenez votre token depuis votre espace personnel dans les parametres du compte.
Base URL
Toutes les requetes utilisent la base URL suivante :
https://finance.hddev.eu/api/v1Format
Toutes les requetes et reponses utilisent le format JSON. Header requis : Content-Type: application/json
Exemple d'authentification
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Endpoints disponibles
Apercu des principaux endpoints de l'API Finance.HDdev.
/api/v1/accountsListe des comptes bancaires connectes avec soldes et metadonnees.
/api/v1/transactionsListe des transactions avec filtres (date, categorie, montant, compte).
/api/v1/budgetsBudgets et objectifs avec progression actuelle.
/api/v1/transactionsCreer une transaction manuelle (depense, revenu ou virement).
/api/v1/categoriesCategories disponibles (systeme et personnalisees).
Rate limits
Les requetes API sont limitees pour garantir la stabilite du service.
Documentation complete
La documentation interactive complete (OpenAPI / Swagger) sera bientot disponible. Elle inclura les schemas de requetes et reponses, les codes d'erreur et des exemples detailles.
Securite
Toutes les communications sont chiffrees via HTTPS/TLS. Les tokens JWT expirent apres 30 minutes (renouvellement automatique via refresh token). L'API est conforme RGPD et ne retourne jamais d'identifiants bancaires.
Besoin d'aide avec l'API ?
Notre equipe technique est disponible pour vous accompagner dans l'integration de l'API Finance.HDdev dans vos outils et workflows.
Contacter l'equipe APIapi@hddev.eu
Principes d'Architecture et Utilisation
L'API de Finance.HDdev est basee sur une architecture RESTful, ce qui la rend previsible et facile a utiliser. Toutes les requetes sont effectuees via HTTPS pour garantir la confidentialite des donnees echangees. Les reponses, ainsi que les corps des requetes POST et PUT, sont systematiquement formates en JSON. La structure des URLs est orientee ressources, vous permettant d'interagir de maniere intuitive avec les differents objets de notre systeme, tels que les comptes, les transactions ou les budgets. Nous appliquons un systeme de limitation de requetes (rate limiting) pour assurer la stabilite de la plateforme pour tous nos utilisateurs. Les details de ces limites sont precises dans l'en-tete de chaque reponse.
Endpoints Cles et Cas d'Usage
Notre API expose plusieurs endpoints pour couvrir l'ensemble des fonctionnalites de gestion financiere. Le endpoint `/transactions` vous permet de lister, filtrer et recuperer les details de chaque transaction, ideal pour des analyses de depenses poussees. Avec `/accounts`, vous pouvez obtenir la liste de vos comptes connectes et leur solde en temps reel. Pour le suivi budgetaire, les endpoints `/budgets` et `/categories` vous donnent un controle total sur la creation et le suivi de vos enveloppes de depenses. Enfin, le endpoint `/goals` permet de gerer vos objectifs d'epargne. Ces outils combines ouvrent la voie a de nombreuses applications, du simple script d'export de donnees a une application mobile complete de coaching financier.
Authentification et Securite de l'API
La securite est notre priorite absolue. L'acces a l'API est protege par des cles d'authentification personnelles que vous pouvez generer, gerer et revoquer depuis votre tableau de bord utilisateur. Chaque requete d'API doit inclure votre cle d'API dans l'en-tete `Authorization` sous la forme d'un Bearer Token. Il est imperatif de conserver ces cles secretes et de ne jamais les exposer cote client (dans du code JavaScript de navigateur, par exemple). Toutes les connexions a l'API sont chiffrees avec TLS (SSL). Nous vous encourageons egalement a utiliser des webhooks pour recevoir des notifications en temps reel sur les evenements importants, comme une nouvelle transaction, plutot que d'interroger l'API en continu, reduisant ainsi le volume de requetes et optimisant les performances.