API Finance.HDdev
Ενσωματώστε το Finance.HDdev στα εργαλεία σας. Αποκτήστε πρόσβαση στους λογαριασμούς, τις συναλλαγές, τους προϋπολογισμούς και τις κατηγορίες σας μέσω ενός απλού και ασφαλούς REST API.
Ταυτοποίηση
Bearer token (JWT). Αποκτήστε το token σας από τον προσωπικό σας χώρο στις ρυθμίσεις λογαριασμού.
Βασικό URL
Όλα τα αιτήματα χρησιμοποιούν το ακόλουθο βασικό URL:
https://finance.hddev.eu/api/v1Μορφή
Όλα τα αιτήματα και οι απαντήσεις χρησιμοποιούν μορφή JSON. Απαιτούμενη κεφαλίδα: Content-Type: application/json
Παράδειγμα ταυτοποίησης
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Διαθέσιμα endpoints
Επισκόπηση των κύριων endpoints του API Finance.HDdev.
/api/v1/accountsΛίστα συνδεδεμένων τραπεζικών λογαριασμών με υπόλοιπα και μεταδεδομένα.
/api/v1/transactionsΛίστα συναλλαγών με φίλτρα (ημερομηνία, κατηγορία, ποσό, λογαριασμός).
/api/v1/budgetsΠροϋπολογισμοί και στόχοι με τρέχουσα πρόοδο.
/api/v1/transactionsΔημιουργία χειροκίνητης συναλλαγής (δαπάνη, έσοδο ή μεταφορά).
/api/v1/categoriesΔιαθέσιμες κατηγορίες (συστήματος και προσαρμοσμένες).
Όρια αιτημάτων
Τα αιτήματα API περιορίζονται για τη διασφάλιση της σταθερότητας της υπηρεσίας.
Πλήρης τεκμηρίωση
Η πλήρης διαδραστική τεκμηρίωση (OpenAPI / Swagger) θα είναι σύντομα διαθέσιμη. Θα περιλαμβάνει σχήματα αιτημάτων και απαντήσεων, κωδικούς σφαλμάτων και λεπτομερή παραδείγματα.
Ασφάλεια
Όλες οι επικοινωνίες κρυπτογραφούνται μέσω HTTPS/TLS. Τα JWT tokens λήγουν μετά από 30 λεπτά (αυτόματη ανανέωση μέσω refresh token). Το API συμμορφώνεται με τον GDPR και δεν επιστρέφει ποτέ τραπεζικά διαπιστευτήρια.
Χρειάζεστε βοήθεια με το API;
Η τεχνική μας ομάδα είναι διαθέσιμη για να σας βοηθήσει με την ενσωμάτωση του API Finance.HDdev στα εργαλεία και τις ροές εργασίας σας.
Επικοινωνία με την ομάδα APIapi@hddev.eu
Αρχές Αρχιτεκτονικής και Χρήση
Το API του Finance.HDdev βασίζεται σε αρχιτεκτονική RESTful, καθιστώντας το προβλέψιμο και εύκολο στη χρήση. Όλα τα αιτήματα γίνονται μέσω HTTPS για τη διασφάλιση του απορρήτου των ανταλλασσόμενων δεδομένων. Οι απαντήσεις, καθώς και τα σώματα αιτημάτων POST και PUT, μορφοποιούνται συστηματικά σε JSON. Η δομή των URL είναι προσανατολισμένη στους πόρους, επιτρέποντάς σας να αλληλεπιδράτε διαισθητικά με τα διαφορετικά αντικείμενα του συστήματός μας, όπως λογαριασμοί, συναλλαγές ή προϋπολογισμοί. Εφαρμόζουμε σύστημα περιορισμού αιτημάτων για τη διασφάλιση της σταθερότητας της πλατφόρμας για όλους τους χρήστες μας. Οι λεπτομέρειες αυτών των ορίων καθορίζονται στην κεφαλίδα κάθε απάντησης.
Βασικά Endpoints και Περιπτώσεις Χρήσης
Το API μας εκθέτει πολλά endpoints για να καλύψει όλα τα χαρακτηριστικά διαχείρισης οικονομικών. Το endpoint `/transactions` σας επιτρέπει να εμφανίσετε, να φιλτράρετε και να ανακτήσετε τις λεπτομέρειες κάθε συναλλαγής, ιδανικό για εις βάθος αναλύσεις δαπανών. Με το `/accounts`, μπορείτε να αποκτήσετε τη λίστα των συνδεδεμένων λογαριασμών σας και τα υπόλοιπά τους σε πραγματικό χρόνο. Για την παρακολούθηση προϋπολογισμού, τα endpoints `/budgets` και `/categories` σας δίνουν πλήρη έλεγχο στη δημιουργία και παρακολούθηση των φακέλων δαπανών σας. Τέλος, το endpoint `/goals` σας επιτρέπει να διαχειριστείτε τους στόχους αποταμίευσής σας. Αυτά τα συνδυασμένα εργαλεία ανοίγουν τον δρόμο σε πολλές εφαρμογές, από ένα απλό σενάριο εξαγωγής δεδομένων μέχρι μια πλήρη εφαρμογή κινητού για χρηματοοικονομική καθοδήγηση.
Ταυτοποίηση και Ασφάλεια API
Η ασφάλεια είναι η απόλυτη προτεραιότητά μας. Η πρόσβαση στο API προστατεύεται από προσωπικά κλειδιά ταυτοποίησης που μπορείτε να δημιουργήσετε, να διαχειριστείτε και να ανακαλέσετε από τον πίνακα ελέγχου χρήστη σας. Κάθε αίτημα API πρέπει να περιλαμβάνει το κλειδί API σας στην κεφαλίδα `Authorization` ως Bearer Token. Είναι επιτακτικό να διατηρείτε αυτά τα κλειδιά μυστικά και να μην τα εκθέτετε ποτέ στην πλευρά του πελάτη (σε κώδικα JavaScript προγράμματος περιήγησης, για παράδειγμα). Όλες οι συνδέσεις API κρυπτογραφούνται με TLS (SSL). Σας ενθαρρύνουμε επίσης να χρησιμοποιείτε webhooks για να λαμβάνετε ειδοποιήσεις σε πραγματικό χρόνο για σημαντικά γεγονότα, όπως μια νέα συναλλαγή, αντί να ρωτάτε συνεχώς το API, μειώνοντας έτσι τον όγκο αιτημάτων και βελτιστοποιώντας την απόδοση.