API Finance.HDdev
Integra Finance.HDdev fl-għodod tiegħek. Aċċessa l-kontijiet, it-tranżazzjonijiet, il-baġits u l-kategoriji tiegħek permezz ta' API REST sempliċi u sigura.
Awtentikazzjoni
Bearer token (JWT). Ikseb it-token tiegħek mid-dashboard personali tiegħek fis-settings tal-kont.
URL Bażi
It-talbiet kollha jużaw l-URL bażi li ġej:
https://finance.hddev.eu/api/v1Format
It-talbiet u t-tweġibiet kollha jużaw il-format JSON. Header meħtieġ: Content-Type: application/json
Eżempju ta' awtentikazzjoni
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Endpoints disponibbli
Ħarsa ġenerali tal-endpoints ewlenin tal-API ta' Finance.HDdev.
/api/v1/accountsLista tal-kontijiet bankarji konnessi bil-bilanċi u l-metadata.
/api/v1/transactionsLista tat-tranżazzjonijiet b'filtri (data, kategorija, ammont, kont).
/api/v1/budgetsBaġits u miri bil-progress attwali.
/api/v1/transactionsOħloq tranżazzjoni manwali (nefqa, dħul jew trasferiment).
/api/v1/categoriesKategoriji disponibbli (tas-sistema u personalizzati).
Limiti tar-rata
It-talbiet tal-API huma llimitati fir-rata biex jiżguraw l-istabbiltà tas-servizz.
Dokumentazzjoni sħiħa
Id-dokumentazzjoni interattiva sħiħa (OpenAPI / Swagger) tkun disponibbli dalwaqt. Tinkludi skemi tat-talbiet u t-tweġibiet, kodiċijiet ta' żbalji u eżempji dettaljati.
Sigurtà
Il-komunikazzjonijiet kollha huma kriptati permezz ta' HTTPS/TLS. It-tokens JWT jiskadu wara 30 minuta (tiġdid awtomatiku permezz ta' refresh token). L-API hija konformi mal-GDPR u qatt ma tirritorna kredenzjali bankarji.
Għandek bżonn għajnuna bl-API?
It-tim tekniku tagħna huwa disponibbli biex jgħinek bl-integrazzjoni tal-API ta' Finance.HDdev fl-għodod u l-workflows tiegħek.
Ikkuntattja t-tim tal-APIapi@hddev.eu
Prinċipji tal-Arkitettura u Użu
L-API ta' Finance.HDdev hija bbażata fuq arkitettura RESTful, li tagħmilha prevedibbli u faċli biex tintuża. It-talbiet kollha jsiru permezz ta' HTTPS biex jiżguraw il-kunfidenzjalità tad-data skambjata. It-tweġibiet, kif ukoll il-bodies tat-talbiet POST u PUT, huma sistematikament ifformattjati f'JSON. L-istruttura tal-URL hija orjentata lejn ir-riżorsi, li tippermetti li tinteraġixxi intuwittivament mal-oġġetti differenti fis-sistema tagħna, bħal kontijiet, tranżazzjonijiet jew baġits. Napplikaw sistema ta' limitazzjoni tar-rata biex niżguraw l-istabbiltà tal-pjattaforma għall-utenti kollha tagħna. Id-dettalji ta' dawn il-limiti huma speċifikati f'kull header tat-tweġiba.
Endpoints Ewlenin u Każijiet ta' Użu
L-API tagħna tesponi diversi endpoints biex tkopri l-karatteristiċi kollha tal-ġestjoni finanzjarja. L-endpoint `/transactions` jippermettilek tellenka, tiffiltra u tiġbor id-dettalji ta' kull tranżazzjoni, ideali għal analiżi fil-fond tan-nefqa. B'`/accounts`, tista' tikseb il-lista tal-kontijiet konnessi tiegħek u l-bilanċi tagħhom f'ħin reali. Għas-segwitu tal-baġit, l-endpoints `/budgets` u `/categories` jagħtuk kontroll sħiħ fuq il-ħolqien u l-monitoraġġ tal-envelops tan-nefqa tiegħek. Fl-aħħarnett, l-endpoint `/goals` jippermettilek timmaniġġja l-miri tat-tfaddil tiegħek. Dawn l-għodod ikkombinati jiftħu l-bieb għal ħafna applikazzjonijiet, minn skript sempliċi ta' esportazzjoni tad-data sa' app mobbli sħiħa ta' coaching finanzjarju.
Awtentikazzjoni u Sigurtà tal-API
Is-sigurtà hija l-prijorità assoluta tagħna. L-aċċess tal-API huwa protett b'ċwievet ta' awtentikazzjoni personali li tista' tiġġenera, timmaniġġja u tirrevoka mid-dashboard tal-utent tiegħek. Kull talba tal-API trid tinkludi ċ-ċavetta tal-API tiegħek fil-header `Authorization` bħala Bearer Token. Huwa imperattiv li żżomm dawn iċ-ċwievet sigrieti u qatt ma tesponihom fuq in-naħa tal-klijent (fil-kodiċi JavaScript tal-browser, per eżempju). Il-konnessjonijiet kollha tal-API huma kriptati b'TLS (SSL). Inħeġġuk ukoll tuża webhooks biex tirċievi notifiki f'ħin reali dwar avvenimenti importanti, bħal tranżazzjoni ġdida, minflok tippollinja l-API kontinwament, b'hekk tnaqqas il-volum tat-talbiet u tottimizza l-prestazzjoni.