---
title: "REST API reference - προγραμματιστές HyperCRM"
description: "Το REST API του HyperCRM με απλά λόγια: ταυτοποίηση με bearer token, οι πόροι που υπάρχουν σήμερα, σελιδοποίηση και ο κοινός φάκελος JSON κάθε endpoint."
canonical: "https://hypercrm.app/el/developers/api"
lang: "el"
updated: "2026-07-25"
---

_Προγραμματιστές / API_

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

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

[Ξεκινήστε δωρεάν δοκιμή](/dashboard) · [Αναφορά API](/el/docs/api)

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

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

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

### Προγραμματισμός

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

### Χρεώσεις

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

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

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

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

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

## Ταυτοποίηση

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

## Τι υπάρχει

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

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

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

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

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

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

### Πόσο κοστίζει το HyperCRM;

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

### Πώς προστατεύονται τα δεδομένα των ασθενών;

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

### Πώς μοιάζει στην πράξη η ταυτοποίηση;

Κάθε κλήση στέλνει `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 πάνω στα δεδομένα του δικού σας ιατρείου, στη δοκιμή. Χωρίς κάρτα για να ξεκινήσετε.

[Ξεκινήστε δωρεάν δοκιμή](/dashboard)