Κράτηση εξετάσεων αίματος μέσα από το δικό σου προϊόν

Ένα κλειδί API σου δίνει 45 τελικά σημεία, από την κράτηση μέχρι τα εργαστηριακά αποτελέσματα

Το Aniva Partner API κλείνει μια αιμοληψία σε περισσότερες από 25 τοποθεσίες στη Γερμανία, προσθέτει πάνελ σε αυτό το ραντεβού και επιστρέφει κλινικά και γενετικά αποτελέσματα σε μορφή JSON. Κάθε αίτημα χρειάζεται μία κεφαλίδα και το βασικό URL είναι το ίδιο σε κάθε περιβάλλον.

Πότε να χρησιμοποιήσεις την Aniva

Χρησιμοποίησε την Aniva όταν οι πελάτες σου χρειάζονται κράτηση εξέτασης αίματος
Χρησιμοποίησε τα endpoints ραντεβού για αιμοληψία σε κλινική και τα endpoints για κιτ εξέτασης για το σπίτι για κιτ που αποστέλλεται ταχυδρομικώς.
Χρησιμοποίησε τα endpoints αποτελεσμάτων για κλινικές γραμμές, γενετικές γραμμές και την αναφορά PDF.
Χρησιμοποίησε τα endpoints του καταλόγου για να διαβάσεις τους βιοδείκτες, τα πάνελ και τις μονάδες που πουλάει η Aniva.
Χρησιμοποίησε τις τεκμηριωμένες διαδρομές κάτω από το https://anivahealth.com/api/v1/ και μην επινοείς endpoints.
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Η βασική ροή αποτελείται από τέσσερα αιτήματα
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 τελικά σημεία είναι τεκμηριωμένα και ενεργά σήμερα

1

Η ταυτοποίηση χρειάζεται μόνο μία κεφαλίδα αιτήματος

v1

Κάθε διαδρομή ξεκινά με το πρόθεμα v1

25+

Τα σημεία στη Γερμανία μπορούν να κάνουν την αιμοληψία

Τέσσερα αιτήματα δημιουργούν μια λειτουργική ενσωμάτωση

Τέσσερα αιτήματα οδηγούν από την κράτηση στα αποτελέσματα του εργαστηρίου

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

Βήμα 01 · GET /locations

Εμφανίζεις τις τοποθεσίες στις οποίες μπορεί να κάνει κράτηση το κλειδί σου

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

Εξετάσεις
Βήμα 02 · POST /profiles

Δημιουργείς ένα προφίλ για τον πελάτη

Ένα προφίλ χρειάζεται όνομα, κωδικό φύλου, ημερομηνία γέννησης και το profile_group σου, το οποίο δέχεται ένα UUID ή το δικό σου slug.

Εξετάσεις
Βήμα 03 · POST /appointments

Κλείνεις το ραντεβού την ώρα που επιλέγεις

Για την κράτηση χρειάζονται το αναγνωριστικό προφίλ, το αναγνωριστικό τοποθεσίας και μια ημερομηνία-ώρα ISO 8601 με τη διαφορά ώρας ή την κατάληξη Z.

Εξετάσεις
Βήμα 04 · POST /appointments/{id}/confirm

Επιβεβαιώνεις την αιμοληψία με το barcode του κιτ

Αυτό το αίτημα ξεκινά την εργαστηριακή παραγγελία και κλειδώνει το ραντεβού, γι' αυτό άλλαξε κάθε πάνελ πριν το στείλεις.

Εξετάσεις
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Δυνατότητα

Κάθε ομάδα πόρων είναι μία συλλογή REST

Μπορείς να παραγγείλεις μια αιμοληψία σε κλινική ή ένα κιτ εξέτασης για το σπίτι ταχυδρομικά. Και τα δύο επιστρέφουν στην ίδια μορφή, οπότε γράφεις τον κώδικα που διαβάζει τα αποτελέσματα μόνο μία φορά.

Προφίλ · 4 τελικά σημεία

Ένα προφίλ είναι το άτομο που εξετάζεις

Αναζητάς ένα προφίλ μέσω email, το δημιουργείς στην ομάδα προφίλ σου και ενημερώνεις τα δημογραφικά στοιχεία αργότερα.

Εξετάσεις
GET /profiles
PATCH /profiles/{id}
Ραντεβού · 15 τελικά σημεία

Ένα ραντεβού περιλαμβάνει τα πάνελ και την αιμοληψία

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

Εξετάσεις
POST /appointments
GET /appointments/{id}/results
Παραγγελίες κιτ εξέτασης για το σπίτι · 10 endpoints

Οι παραγγελίες κιτ εξέτασης για το σπίτι είναι η ταχυδρομική εκδοχή

Δέκα endpoints ζητούν ένα κιτ DIY για ένα προφίλ, αλλάζουν τα πάνελ του και επιστρέφουν την ίδια δομή αποτελέσματος.

Εξετάσεις
Δημιουργία παραγγελίας κιτ
Λήψη αποτελεσμάτων
Τοποθεσίες · 2 τελικά σημεία

Οι τοποθεσίες σου δείχνουν πού γίνεται η αιμοληψία

Διαβάζεις τις τοποθεσίες στις οποίες μπορεί να κάνει κράτηση το κλειδί σου και μετά ζητάς από μία από αυτές τις διαθέσιμες ώρες έναρξης.

Εξετάσεις
GET /locations
GET /locations/{id}/availability
Έγγραφα · 1 endpoint

Τα αποτελέσματα επιστρέφουν ως κλινικές και γενετικές γραμμές

Κάθε τύπος παραγγελίας έχει τη δική του κλήση αποτελεσμάτων και η αναφορά PDF είναι μια ξεχωριστή λήψη με βάση το ID αρχείου.

Εξετάσεις
GET /appointments/{id}/results
GET /documents/{id}
Αποστολές · 8 τελικά σημεία

Ένας κούριερ μεταφέρει το δείγμα στο εργαστήριο

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

Εξετάσεις
POST /shipments
Επισύναψη ραντεβού
Κατάλογοι · 4 τελικά σημεία

Οι κατάλογοι περιλαμβάνουν τους βιοδείκτες που μπορείς να παραγγείλεις

Οι κατάλογοι βιοδεικτών, πάνελ και μονάδων είναι σελιδοποιημένοι, και μπορείς να φιλτράρεις τους βιοδείκτες ανά τοποθεσία εξέτασης.

Εξετάσεις
GET /biomarkers
GET /panels
Υγεία · 1 τελικό σημείο

Ένα endpoint ετοιμότητας δεν χρειάζεται κλειδί API

Ο έλεγχος ετοιμότητας δεν χρειάζεται κλειδί API, ώστε το εργαλείο παρακολούθησης διαθεσιμότητάς σου να μπορεί να τον καλεί προγραμματισμένα.

Εξετάσεις
Δημόσιος έλεγχος ετοιμότητας
Η δουλειά σου τελειώνει με την επιβεβαίωση του barcode

Η εργαστηριακή διαδικασία ξεκινά όταν επιβεβαιώσεις την αιμοληψία

Μας στέλνεις το barcode του κιτ και αυτό είναι το τελευταίο που χρειαζόμαστε από εσένα. Στη συνέχεια οργανώνουμε τα δοχεία, την ταχυμεταφορά και το εργαστήριο, ώστε ο κώδικάς σου να καλεί μόνο δύο endpoints μέχρι να είναι έτοιμη η αναφορά.

The Aniva lab pipeline from confirmation to results Confirming the draw is followed by container selection, courier collection and laboratory analysis, and each biomarker row then reads as planned, received or fault. POST /appointments/{id}/confirmYou confirm the draw GET /appointments/{id}/previewContainers are known POST /shipmentsA courier collects it Aniva laboratory networkThe laboratory analyses planned received fault GET /appointments/{id}/results
Μια γεμάτη κουκκίδα είναι η διαδρομή που θέλεις.Ένας δακτύλιος είναι μια κατάσταση που διαχειρίζεσαι ακόμα.Οι πορτοκαλί γραμμές είναι η επιβεβαιωμένη παραγγελία.
Ένας parser διαβάζει την αιμοληψία σε κλινική και το κιτ εξέτασης για το σπίτι

Κάθε αποτέλεσμα έχει δύο εύρη αναφοράς και τέσσερις καταστάσεις

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

Μια γραμμή έχει την ένδειξη προγραμματισμένο πριν την αναλύσει το εργαστήριο.
Μια γραμμή εμφανίζει ελήφθη μόλις επιστραφούν τιμή και μονάδα.
Μια γραμμή εμφανίζει fault όταν το εργαστήριο ακύρωσε το αίτημα, και το status_reason το εξηγεί.
GET /api/v1/appointments/{id}/results
{
  "status": "in_progress",
  "clinical_results": [{
    "status": "received",
    "biomarker_name": "Vitamin D",
    "value": 38.5, "unit": "ng/mL",
    "reference_range_lab": { "normal_min": 30, "normal_max": 100 },
    "reference_range_aniva": { "optimal_min": 40, "optimal_max": 60 },
    "tested_at": "2026-04-05"
  }],
  "documents": [{ "file_name": "lab-report-2026-04-05.pdf" }]
}
Το API χρησιμοποιεί τρεις μορφές χρόνου

Οι ημερομηνίες με ώρα χρειάζονται ζώνη ώρας, αλλιώς το αίτημα αποτυγχάνει

Μια ημερομηνία-ώρα χωρίς ζώνη ώρας απορρίπτεται με 400, που είναι το ένα λάθος που κάνουν οι περισσότερες πρώτες ενσωματώσεις.

Οι χρονοσφραγίδες επιστρέφουν πάντα σε UTC, με μορφή ISO 8601 και την κατάληξη Z.
Τα δεδομένα εισόδου πρέπει να περιλαμβάνουν ρητή μετατόπιση ώρας, οπότε μια κράτηση δέχεται το 2026-05-15T12:30:00+02:00.
Οι ενημερώσεις αποστολής διατηρούν τη χρονική διαφορά που ανέφερε ο πάροχος μεταφορών.
Τα ημερολογιακά πεδία αφορούν μόνο την ώρα ρολογιού, όπως η ημερομηνία γέννησης.
Η Aniva εκδίδει και εναλλάσσει κάθε κλειδί συνεργάτη

Κάθε αίτημα χρειάζεται το κλειδί API συνεργάτη σου

Ο έλεγχος ταυτότητας χρησιμοποιεί την κεφαλίδα x-api-key σε κάθε κλήση, και ένα κλειδί που λείπει ή έχει αντικατασταθεί επιστρέφει 403 με ένα σύντομο σφάλμα JSON.

Το κλειδί σου καθορίζει ποιες τοποθεσίες, ραντεβού και αποστολές μπορείς να βλέπεις.
Μην εκθέτεις ποτέ το κλειδί API σου σε κώδικα client-side ή σε δημόσια αποθετήρια.
Ένας δημόσιος έλεγχος δεν χρειάζεται κλειδί API

Μπορείς να παρακολουθείς κάθε υπηρεσία στη σελίδα κατάστασης

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

Τα κλειδιά συνεργατών εκδίδονται από την ομάδα μας

Ζήτησέ μας κλειδί συνεργάτη σήμερα

Πες μας σε ποιες αγορές πουλάς και ποια πάνελ χρειάζεσαι, και θα σου στείλουμε ένα κλειδί με τα κατάλληλα δικαιώματα.

Μπορείς επίσης να κατεβάσεις το αρχείο OpenAPI

Αυτή η σελίδα είναι μια σχεδιαστική μακέτα. Κάθε endpoint και payload σε αυτή προέρχεται από το docs.anivahealth.com και το διάγραμμα ροής είναι ενδεικτικό.

Μηχανικά αναγνώσιμα αντίγραφα της τεκμηρίωσης βρίσκονται στις διευθύνσεις docs.anivahealth.com/llms.txt και docs.anivahealth.com/llms-full.txt.