Vai al contenuto principale
Usa questa guida per trovare una sede per gli esami, creare un appuntamento per un profilo paziente e associare i pannelli di esami da eseguire. Completa questi passaggi prima che il paziente arrivi per il prelievo di sangue.
1

Esplora le sedi disponibili

Recupera l’elenco delle sedi per gli esami disponibili sul tuo account inviando una richiesta GET a /api/v1/locations.
La risposta è un array di oggetti sede:
Usa il campo timezone dell’oggetto sede quando costruisci il timestamp scheduled_at. Convertire l’orario dell’appuntamento nel fuso orario locale della sede ti aiuta a evitare prenotazioni fuori dagli orari di apertura.
Non ricavare gli orari prenotabili solo da open_hours. Chiama Ottieni disponibilità e prenota un orario di inizio restituito — quella griglia tiene conto anche delle prenotazioni esistenti, delle eccezioni per data e del preavviso minimo.
2

Crea l'appuntamento

Invia una richiesta POST a /api/v1/appointments con l’ID del profilo, l’ID della sede e l’orario desiderato. L’orario deve corrispondere all’inizio di uno slot restituito da Ottieni disponibilità.
scheduled_at deve essere una data e ora futura in formato ISO 8601, ad esempio 2026-05-12T07:30:00Z. I timestamp nel passato vengono rifiutati con un errore 400, così come gli orari entro il preavviso minimo di 12 ore presso le sedi gestite da Aniva.
Ripetere questa richiesta è sicuro. Un profilo può avere un solo appuntamento per sede e orario, quindi una richiesta reinviata o duplicata restituisce 409 con l’appointment_id esistente invece di prenotare il paziente due volte.
Una richiesta riuscita restituisce 201 Created con l’oggetto appuntamento:
Salva l’id dell’appuntamento — ti servirà per aggiungere pannelli e confermare il prelievo di sangue.
3

Aggiungi pannelli di esami

Associa i pannelli di esami che vuoi eseguire sul campione di sangue inviando una richiesta POST a /api/v1/appointments/{id}/panels.Gli ID dei pannelli sono UUID. Chiama Elenca pannelli per ottenere i pannelli che la tua chiave API può ordinare.
Non è possibile aggiungere pannelli dopo la conferma del prelievo di sangue. Aggiungi tutti i pannelli necessari prima della conferma — vedi Conferma il prelievo di sangue per i dettagli.
Una richiesta riuscita restituisce 200 OK a conferma dell’aggiunta dei pannelli:

Riprogrammazione o annullamento

Dopo aver creato un appuntamento, puoi ancora modificarlo prima che il prelievo di sangue venga confermato:
  • Riprogramma o cambia sede — Invia una richiesta PATCH a /api/v1/appointments/{id} con i campi da aggiornare. Vedi Aggiorna appuntamento.
  • Annulla — Invia una richiesta DELETE a /api/v1/appointments/{id}. Vedi Annulla appuntamento.
Entrambe le operazioni sono disponibili solo prima del prelievo di sangue — cioè mentre l’appuntamento è nello stato pending o confirmed. Una volta che l’appuntamento passa a blood_drawn, non sono possibili ulteriori modifiche.

Gestione degli errori