API Finance.HDdev
Integrează Finance.HDdev în instrumentele tale. Accesează-ți conturile, tranzacțiile, bugetele și categoriile printr-un API REST simplu și securizat.
Autentificare
Bearer token (JWT). Obține-ți tokenul din panoul personal, în setările contului.
URL de bază
Toate cererile folosesc următorul URL de bază:
https://finance.hddev.eu/api/v1Format
Toate cererile și răspunsurile folosesc format JSON. Header necesar: Content-Type: application/json
Exemplu de autentificare
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Endpoint-uri disponibile
Prezentare generală a principalelor endpoint-uri API Finance.HDdev.
/api/v1/accountsLista conturilor bancare conectate cu solduri și metadate.
/api/v1/transactionsLista tranzacțiilor cu filtre (dată, categorie, sumă, cont).
/api/v1/budgetsBugete și obiective cu progresul actual.
/api/v1/transactionsCreează o tranzacție manuală (cheltuială, venit sau transfer).
/api/v1/categoriesCategorii disponibile (de sistem și personalizate).
Limite de rată
Cererile API au limite de rată pentru a asigura stabilitatea serviciului.
Documentație completă
Documentația interactivă completă (OpenAPI / Swagger) va fi disponibilă în curând. Va include scheme de cereri și răspunsuri, coduri de eroare și exemple detaliate.
Securitate
Toate comunicațiile sunt criptate prin HTTPS/TLS. Token-urile JWT expiră după 30 de minute (reînnoire automată prin refresh token). API-ul este conform GDPR și nu returnează niciodată credențiale bancare.
Ai nevoie de ajutor cu API-ul?
Echipa noastră tehnică este disponibilă pentru a te asista în integrarea API-ului Finance.HDdev în instrumentele și fluxurile tale de lucru.
Contactează echipa APIapi@hddev.eu
Principii de arhitectură și utilizare
API-ul Finance.HDdev este bazat pe o arhitectură RESTful, făcându-l previzibil și ușor de utilizat. Toate cererile se fac prin HTTPS pentru a asigura confidențialitatea datelor schimbate. Răspunsurile, precum și corpurile cererilor POST și PUT, sunt formatate sistematic în JSON. Structura URL este orientată pe resurse, permițându-ți să interacționezi intuitiv cu diferitele obiecte din sistemul nostru, precum conturi, tranzacții sau bugete. Aplicăm un sistem de limitare a ratei pentru a asigura stabilitatea platformei pentru toți utilizatorii noștri. Detaliile acestor limite sunt specificate în fiecare header de răspuns.
Endpoint-uri cheie și cazuri de utilizare
API-ul nostru expune mai multe endpoint-uri pentru a acoperi toate funcționalitățile de gestionare financiară. Endpoint-ul `/transactions` îți permite să listezi, filtrezi și obții detaliile fiecărei tranzacții, ideal pentru analize aprofundate ale cheltuielilor. Cu `/accounts`, poți obține lista conturilor conectate și soldurile lor în timp real. Pentru urmărirea bugetului, endpoint-urile `/budgets` și `/categories` îți oferă control complet asupra creării și monitorizării plicurilor de cheltuieli. În final, endpoint-ul `/goals` îți permite să gestionezi obiectivele de economisire. Aceste instrumente combinate deschid ușa către multe aplicații, de la un simplu script de export de date la o aplicație mobilă completă de coaching financiar.
Autentificarea și securitatea API
Securitatea este prioritatea noastră absolută. Accesul la API este protejat prin chei de autentificare personale pe care le poți genera, gestiona și revoca din panoul tău de utilizator. Fiecare cerere API trebuie să includă cheia ta API în headerul `Authorization` ca Bearer Token. Este imperativ să păstrezi aceste chei secrete și să nu le expui niciodată pe partea clientului (în codul JavaScript al browserului, de exemplu). Toate conexiunile API sunt criptate cu TLS (SSL). Te încurajăm de asemenea să folosești webhook-uri pentru a primi notificări în timp real despre evenimente importante, precum o nouă tranzacție, în loc să interoghezi continuu API-ul, reducând astfel volumul de cereri și optimizând performanța.