Μετάβαση στο περιεχόμενο
Προγραμματιστές / API

Το ίδιο API που καλεί η εφαρμογή

Το REST API του HyperCRM είναι μια διεπαφή μόνο JSON, με εμβέλεια το ιατρείο σας και ταυτοποίηση με bearer token. Είναι το ίδιο επίπεδο που χρησιμοποιεί εσωτερικά η εφαρμογή, όχι περικομμένο αντίγραφο, και καλύπτει ασθενείς, προγραμματισμό, χρεώσεις, φόρμες, αρχεία, ετικέτες, αναζήτηση και αναφορές.

Οικογένειες πόρων

Ασθενείς & σημειώσεις

Δημιουργία, ενημέρωση και αναζήτηση αρχείων ασθενών, με εναλλαγή ετικετών και κλινικές σημειώσεις με ιστορικό.

Ημερολόγιο

Ραντεβού, καταχωρίσεις μπλοκαρίσματος έδρας, και ένα endpoint διαθεσιμότητας για μια έδρα σε συγκεκριμένη ημέρα.

Χρεώσεις

Κατάλογος υπηρεσιών, χρεώσεις/πιστώσεις/εισπράξεις ανά ασθενή, και υπολογισμένη προβολή απόδειξης ή τιμολογίου με ΦΠΑ.

Φόρμες & αρχεία

Εργαλείο δυναμικών φορμών με δημόσιους συνδέσμους, και ιδιωτική αποθήκευση αρχείων μέσω signed URLs.

Ποιο πακέτο χρειάζεται

Το REST API και ο MCP server περιλαμβάνονται στο πακέτο Complete και δεν διατίθενται στο Essential — οι ενσωματώσεις είναι ανάγκη μεγαλύτερων ιατρείων και πραγματικό φορτίο υποστήριξης, οπότε βρίσκονται στο πακέτο που τις πληρώνει. Η σελίδα τιμών έχει κάθε κλίμακα. Οι OAuth clients δημιουργούνται από τις ρυθμίσεις του ιατρείου μόλις βρεθείτε στο Complete.

Ταυτοποίηση

Κάθε endpoint απαιτεί Authorization: Bearer <token>. Το token είναι συνήθως ένα Firebase ID token από συνδεδεμένη συνεδρία HyperCRM· δεν υπάρχει ξεχωριστό βήμα εγγραφής — ο χρήστης, το ιατρείο και η ιδιότητά σας δημιουργούνται αυτόματα στην πρώτη επιτυχή επαλήθευση. Οι OAuth clients (δείτε τη σελίδα MCP) μπορούν να χρησιμοποιήσουν αδιαφανές access token αντ' αυτού, και οι δύο μορφές λειτουργούν εναλλάξιμα όπου γίνεται δεκτό bearer token.

Τι υπάρχει

Ασθενείς και σημειώσεις ασθενών, ετικέτες, ραντεβού και διαθεσιμότητα έδρας, ο κατάλογος υπηρεσιών και οι χρεώσεις ανά ασθενή με υπολογισμένη προβολή απόδειξης ή τιμολογίου, εργαλείο φορμών με δημόσιους συνδέσμους, ιδιωτική αποθήκευση αρχείων μέσω συνδέσμων περιορισμένης διάρκειας, αναζήτηση σε ασθενείς και ραντεβού, KPI πίνακα ελέγχου και αναφορές μόνο για ιδιοκτήτες, και διαχείριση προσωπικού/προσκλήσεων. Κάθε ιατρείο έχει επίσης ένα packId (γενικό ή οδοντιατρικό σήμερα), και τιμές ειδικές ανά πακέτο, όπως οι καταστάσεις ασθενή, έρχονται από ένα endpoint εκκίνησης αντί να είναι σταθεροποιημένες στο API.

Αιτήματα και απαντήσεις

Οι επιτυχείς απαντήσεις μοιράζονται έναν φάκελο: ένα πεδίο data με τον πόρο, και ένα requestId για συσχέτιση υποστήριξης. Τα σφάλματα μοιράζονται την αντίστροφη μορφή — σταθερό code, ασφαλές μήνυμα εμφάνισης, και προαιρετικά details για ζητήματα επικύρωσης ανά πεδίο. Τα endpoints λιστών όπως οι ασθενείς δέχονται limit και offset· τιμές εκτός εύρους περιορίζονται αντί να απορρίπτονται, και η απάντηση επιστρέφει τις τιμές που τελικά χρησιμοποιήθηκαν.

Τι να περιμένετε από αυτό

Το API είναι αυτό που καλεί το ίδιο το προϊόν, οπότε εξελίσσεται μαζί του αντί να μένει πίσω. Δεν υπάρχει επίσημο SDK ούτε σύστημα webhooks. Τα όρια αιτημάτων δημοσιεύονται: κάθε λειτουργία στο έγγραφο OpenAPI δηλώνει το όριο που την διέπει. Η πλήρης αναφορά — κάθε endpoint, τα πεδία του και τα σφάλματα που επιστρέφει — βρίσκεται στην Αναφορά API.

Συχνές ερωτήσεις

Το HyperCRM είναι λογισμικό επί πληρωμή. Κάθε ιατρείο ξεκινά με δωρεάν δοκιμή 30 ημερών στο πακέτο Complete, χωρίς κάρτα. Στη συνέχεια τα πακέτα ξεκινούν από 19 € και 34 € τον μήνα, με ΦΠΑ. Η τιμή εξαρτάται από το πόσους επαγγελματίες υγείας απασχολείτε. Κάθε τιμή βρίσκεται στη σελίδα τιμών, οπότε δεν χρειάζεται να μιλήσετε με πωλητή.

Οι καρτέλες ασθενών κρυπτογραφούνται, και εκεί που φυλάσσονται και καθώς έρχονται στην οθόνη σας. Τα αρχεία είναι ιδιωτικά, και ο σύνδεσμος προς ένα αρχείο σταματά να δουλεύει μετά από λίγο. Οι αλλαγές στις καρτέλες των ασθενών καταγράφονται, με το ποιος τις έκανε και πότε. Δεν υπάρχει κοινός κωδικός ιατρείου: ο καθένας έχει τον δικό του λογαριασμό. Στο πακέτο Complete, ο ιδιοκτήτης του ιατρείου μπορεί επίσης να απαιτεί σύνδεση σε δύο βήματα για όλη την ομάδα.

Κάθε κλήση στέλνει Authorization: Bearer <token>, συνήθως ένα Firebase ID token από συνδεδεμένη συνεδρία, που επαληθεύεται στον διακομιστή σε κάθε αίτημα. Δεν υπάρχει ξεχωριστό βήμα κλειδιού API: το ιατρείο και η ιδιότητά σας προκύπτουν από το ίδιο token, και η πρόσβαση περιορίζεται πάντα στα δεδομένα του δικού σας ιατρείου.

Ναι. Κάθε endpoint έχει όριο αιτημάτων, και κάθε λειτουργία στο έγγραφο OpenAPI στο /api/v1/openapi.json δηλώνει το όριο που ισχύει για αυτήν. Κάθε απάντηση μεταφέρει επίσης το υπόλοιπό σας στις κεφαλίδες RateLimit-Limit, RateLimit-Remaining και RateLimit-Reset, ώστε ένας client να μπορεί να επιβραδύνει πριν περιοριστεί και όχι μετά. Ένα αίτημα που περιορίζεται επιστρέφει 429 με rate_limit_exceeded και κεφαλίδα Retry-After.

Χτίστε πάνω στα ίδια δεδομένα που χρησιμοποιεί η εφαρμογή

Ένα bearer token πάνω στα δεδομένα του δικού σας ιατρείου, στη δοκιμή. Χωρίς κάρτα για να ξεκινήσετε.

Ξεκινήστε δωρεάν δοκιμή