Ένα κλειδί API σου δίνει 45 τελικά σημεία, από την κράτηση μέχρι τα εργαστηριακά αποτελέσματα
Το Aniva Partner API κλείνει μια αιμοληψία σε περισσότερες από 25 τοποθεσίες στη Γερμανία, προσθέτει πάνελ σε αυτό το ραντεβού και επιστρέφει κλινικά και γενετικά αποτελέσματα σε μορφή JSON. Κάθε αίτημα χρειάζεται μία κεφαλίδα και το βασικό URL είναι το ίδιο σε κάθε περιβάλλον.
Πότε να χρησιμοποιήσεις την Aniva
45 τελικά σημεία είναι τεκμηριωμένα και ενεργά σήμερα
Η ταυτοποίηση χρειάζεται μόνο μία κεφαλίδα αιτήματος
Κάθε διαδρομή ξεκινά με το πρόθεμα v1
Τα σημεία στη Γερμανία μπορούν να κάνουν την αιμοληψία
Τέσσερα αιτήματα οδηγούν από την κράτηση στα αποτελέσματα του εργαστηρίου
Κάθε αίτημα επιστρέφει το ID που χρειάζεται το επόμενο, οπότε μια βασική ενσωμάτωση είναι τέσσερα αιτήματα πριν προσθέσεις πάνελ, επαναπρογραμματισμούς ή κούριερ.
Εμφανίζεις τις τοποθεσίες στις οποίες μπορεί να κάνει κράτηση το κλειδί σου
Η απόκριση σου δίνει κάθε διεύθυνση, το ωράριο λειτουργίας και τη ζώνη ώρας, ώστε ο πελάτης να βλέπει μόνο ώρες που υπάρχουν.
Δημιουργείς ένα προφίλ για τον πελάτη
Ένα προφίλ χρειάζεται όνομα, κωδικό φύλου, ημερομηνία γέννησης και το profile_group σου, το οποίο δέχεται ένα UUID ή το δικό σου slug.
Κλείνεις το ραντεβού την ώρα που επιλέγεις
Για την κράτηση χρειάζονται το αναγνωριστικό προφίλ, το αναγνωριστικό τοποθεσίας και μια ημερομηνία-ώρα ISO 8601 με τη διαφορά ώρας ή την κατάληξη Z.
Επιβεβαιώνεις την αιμοληψία με το barcode του κιτ
Αυτό το αίτημα ξεκινά την εργαστηριακή παραγγελία και κλειδώνει το ραντεβού, γι' αυτό άλλαξε κάθε πάνελ πριν το στείλεις.
Κάθε ομάδα πόρων είναι μία συλλογή REST
Μπορείς να παραγγείλεις μια αιμοληψία σε κλινική ή ένα κιτ εξέτασης για το σπίτι ταχυδρομικά. Και τα δύο επιστρέφουν στην ίδια μορφή, οπότε γράφεις τον κώδικα που διαβάζει τα αποτελέσματα μόνο μία φορά.
Ένα προφίλ είναι το άτομο που εξετάζεις
Αναζητάς ένα προφίλ μέσω email, το δημιουργείς στην ομάδα προφίλ σου και ενημερώνεις τα δημογραφικά στοιχεία αργότερα.
Ένα ραντεβού περιλαμβάνει τα πάνελ και την αιμοληψία
Δεκαπέντε τελικά σημεία καλύπτουν την κράτηση και κάθε μεταγενέστερη αλλαγή της, συμπεριλαμβανομένων των πάνελ, των προεπισκοπήσεων δοχείων και της επιβεβαίωσης.
Οι παραγγελίες κιτ εξέτασης για το σπίτι είναι η ταχυδρομική εκδοχή
Δέκα endpoints ζητούν ένα κιτ DIY για ένα προφίλ, αλλάζουν τα πάνελ του και επιστρέφουν την ίδια δομή αποτελέσματος.
Οι τοποθεσίες σου δείχνουν πού γίνεται η αιμοληψία
Διαβάζεις τις τοποθεσίες στις οποίες μπορεί να κάνει κράτηση το κλειδί σου και μετά ζητάς από μία από αυτές τις διαθέσιμες ώρες έναρξης.
Τα αποτελέσματα επιστρέφουν ως κλινικές και γενετικές γραμμές
Κάθε τύπος παραγγελίας έχει τη δική του κλήση αποτελεσμάτων και η αναφορά PDF είναι μια ξεχωριστή λήψη με βάση το ID αρχείου.
Ένας κούριερ μεταφέρει το δείγμα στο εργαστήριο
Δημιουργείς μια παραγγελία κούριερ με παράθυρο παραλαβής σε εργάσιμη ημέρα, στη συνέχεια συνδέεις ραντεβού και βλέπεις τις ενημερώσεις κατάστασής της.
Οι κατάλογοι περιλαμβάνουν τους βιοδείκτες που μπορείς να παραγγείλεις
Οι κατάλογοι βιοδεικτών, πάνελ και μονάδων είναι σελιδοποιημένοι, και μπορείς να φιλτράρεις τους βιοδείκτες ανά τοποθεσία εξέτασης.
Ένα endpoint ετοιμότητας δεν χρειάζεται κλειδί API
Ο έλεγχος ετοιμότητας δεν χρειάζεται κλειδί API, ώστε το εργαλείο παρακολούθησης διαθεσιμότητάς σου να μπορεί να τον καλεί προγραμματισμένα.
Η εργαστηριακή διαδικασία ξεκινά όταν επιβεβαιώσεις την αιμοληψία
Μας στέλνεις το barcode του κιτ και αυτό είναι το τελευταίο που χρειαζόμαστε από εσένα. Στη συνέχεια οργανώνουμε τα δοχεία, την ταχυμεταφορά και το εργαστήριο, ώστε ο κώδικάς σου να καλεί μόνο δύο endpoints μέχρι να είναι έτοιμη η αναφορά.
Κάθε αποτέλεσμα έχει δύο εύρη αναφοράς και τέσσερις καταστάσεις
Κάθε κλινική γραμμή περιέχει το εύρος που ανέφερε το εργαστήριο και το εύρος της Aniva με το βέλτιστο παράθυρό του, ώστε να μπορείς να εμφανίζεις και τα δύο χωρίς να διατηρείς δικό σου πίνακα αντιστοίχισης.
Οι ημερομηνίες με ώρα χρειάζονται ζώνη ώρας, αλλιώς το αίτημα αποτυγχάνει
Μια ημερομηνία-ώρα χωρίς ζώνη ώρας απορρίπτεται με 400, που είναι το ένα λάθος που κάνουν οι περισσότερες πρώτες ενσωματώσεις.
Κάθε αίτημα χρειάζεται το κλειδί API συνεργάτη σου
Ο έλεγχος ταυτότητας χρησιμοποιεί την κεφαλίδα x-api-key σε κάθε κλήση, και ένα κλειδί που λείπει ή έχει αντικατασταθεί επιστρέφει 403 με ένα σύντομο σφάλμα JSON.
Μπορείς να παρακολουθείς κάθε υπηρεσία στη σελίδα κατάστασης
Η σελίδα κατάστασης δείχνει την τρέχουσα κατάσταση και ιστορικό 90 ημερών για κάθε υπηρεσία, ενώ τα ίδια δεδομένα είναι διαθέσιμα σε μορφή JSON για το δικό σου σύστημα παρακολούθησης.
Ζήτησέ μας κλειδί συνεργάτη σήμερα
Πες μας σε ποιες αγορές πουλάς και ποια πάνελ χρειάζεσαι, και θα σου στείλουμε ένα κλειδί με τα κατάλληλα δικαιώματα.
Αυτή η σελίδα είναι μια σχεδιαστική μακέτα. Κάθε endpoint και payload σε αυτή προέρχεται από το docs.anivahealth.com και το διάγραμμα ροής είναι ενδεικτικό.
Μηχανικά αναγνώσιμα αντίγραφα της τεκμηρίωσης βρίσκονται στις διευθύνσεις docs.anivahealth.com/llms.txt και docs.anivahealth.com/llms-full.txt.