API Finance.HDdev
Integralja a Finance.HDdev-et eszkozei. Ferjen hozza szamlaihoz, tranzakcioinhoz, koltsegveteseihez es kategoriaihoz egy egyszeru es biztonsagos REST API-n keresztul.
Hitelesites
Bearer token (JWT). Szerezze be tokenjet szemelyes vezerlopultjarol a fiokbeallitasokban.
Alap URL
Minden keres a kovetkezo alap URL-t hasznalja:
https://finance.hddev.eu/api/v1Formatum
Minden keres es valasz JSON formatumot hasznall. Kotelezo fejlec: Content-Type: application/json
Hitelesitesi pelda
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Elerheto vegpontok
A Finance.HDdev API fo vegpontjainak attekintese.
/api/v1/accountsCsatlakoztatott bankszamlak listaja egyenlegekkel es metaadatokkal.
/api/v1/transactionsTranzakciok listaja szurokkel (datum, kategoria, osszeg, szamla).
/api/v1/budgetsKoltsegvetesek es celok aktualis haladssal.
/api/v1/transactionsManualis tranzakcio letrehozasa (kiadas, bevetel vagy atutalas).
/api/v1/categoriesElerheto kategoriak (rendszer es egyeni).
Sebessegkorlatozasok
Az API keresek sebessegkorlatozottak a szolgaltatas stabilitasnak biztositasa erdekeben.
Teljes dokumentacio
A teljes interaktiv dokumentacio (OpenAPI / Swagger) hamarosan elerheto lesz. Tartalmazni fogja a keres- es valaszsemakat, hibakodokat es reszletes peldakat.
Biztonsag
Minden kommunikacio HTTPS/TLS-en keresztul titkositott. A JWT tokenek 30 perc utan lejarnak (automatikus megujitas refresh tokennel). Az API GDPR kompatibilis es soha nem ad vissza banki bejelentkezesi adatokat.
Segitsegre van szuksege az API-val?
Technikai csapatunk keszseggel segit a Finance.HDdev API integralasaban eszkozei es munkafolyamatai szamara.
Kapcsolat az API csapattalapi@hddev.eu
Architekturaf elvek es hasznalat
A Finance.HDdev API RESTful architekturan alapul, ami kiszamithatova es konnyen hasznalhatova teszi. Minden keres HTTPS-en keresztul tortenik a kicserelt adatok bizalmassaganak biztositasa erdekeben. A valaszok, valamint a POST es PUT kerestorzsek rendszeresen JSON formatumban kerulnek formattazasra. Az URL-struktura erforras-orientalt, lehetove tve az intuitiv interakciot rendszerunk kulonbozo objektumaival, mint peldaul szamlak, tranzakciok vagy koltsegvetesek. A platformstabilitas biztositasa erdekeben osszes felhasznalnak sebessegkorlatozo rendszert alkalmazunk. E korlatozasok reszletei minden valaszfejlecben szerepelnek.
Kulcs vegpontok es felhasznalasi esetek
API-nk tobb vegpontot tesz elérhetove a penzugyi kezeles osszes funkciojanak lefedesere. A `/transactions` vegpont lehetove teszi tranzakciok listazasat, szureset es reszleteinek lekerest, idealis az alapos kiadaselemzesekhez. A `/accounts` segitsegevel lekerherti csatlakoztatott szamlai listajat es valos ideju egyenlegeiket. A koltsegvetes-koveteshez a `/budgets` es `/categories` vegpontok teljes kontrollt biztositanak koltsegkeretei letrehozasa es nyomon kovetese felett. Vegul a `/goals` vegpont lehetove teszi megtakaritasi celjai kezelesetiket. Ezek az eszkozok egyuttesen szamos alkalmazasnak nyitnak ajtot, az egyszeru adatexportalasra irt szkripttol a teljes mobil penzugyi coaching alkalmazasig.
API hitelesites es biztonsag
A biztonsag abszolut prioritasunk. Az API hozzaferest szemelyes hitelesitesi kulcsok vedik, amelyeket felhasznaloi vezerlopultjarol generalhat, kezelhet es vonhat vissza. Minden API-keresnek tartalmaznia kell az API-kulcsot az `Authorization` fejlecben Bearer Token formatumban. Feltetlenul szukseges ezeket a kulcsokat titkos tartani es soha nem kitenni kliens oldalon (peldaul bongesso JavaScript kodjaban). Minden API-kapcsolat TLS-sel (SSL) van tikositva. Arra is buzditjuk, hogy webhookokat hasznaljon valos ideju ertesitesek fogadasara fontos esemenyekrol, mint peldaul uj tranzakcio, ahelyett, hogy folyamatosan lekerdezne az API-t, csokentve ezzel a keresek szamat es optimalizalva a teljesitmenyt.