Saltar al contingut principal
GET
Obtén una única cita d’extracció de sang pel seu UUID, inclòs el perfil integrat del pacient. Utilitza aquest endpoint per comprovar l’estat de la cita, confirmar els detalls de la programació o obtenir les dades del perfil associat. Requereix l’àmbit appointments_view o appointments_schedule.

Sol·licitud

Paràmetres de ruta

string
requerit
Identificador únic (UUID) de la cita que vols obtenir.

Resposta

En cas d’èxit, l’API retorna 200 OK amb la cita i el seu perfil integrat.
string
requerit
Identificador únic de la cita (UUID).
string
requerit
UUID del perfil al qual pertany aquesta cita.
string
UUID de la ubicació de proves on es fa l’extracció de sang.
string
Data i hora programades de la cita com a instant UTC (ISO 8601 amb el sufix Z, p. ex., 2026-05-15T10:30:00Z). Pot ser null.
string
requerit
Estat actual de la cita. Pot ser pending, confirmed, blood_drawn o cancelled. El detall de compleció dels resultats de laboratori s’obté mitjançant Obtén els resultats; el progrés detallat de l’enviament, a partir de cada entrada de la matriu shipments inclosa aquí (més avall) seguida a Obtén l’enviament.
string
Motiu en text lliure registrat en cancel·lar la cita (p. ex., absència, cancel·lació tardana, «Error. Cal repetir»). null llevat que status sigui cancelled.
string[]
requerit
Adreces que reben un correu electrònic cadascuna quan tots els resultats del laboratori són definitius, en minúscules. Buit quan està desactivat. Consulta Correus electrònics de resultats a punt.
string
requerit
Com es fa l’extracció de sang: capillary (de la punta del dit o de la part superior del braç, en microtubs) o venous (de la vena, en tubs). És el mètode definit a la cita o, si no n’hi ha, el default_draw_method de la seva ubicació. Després de l’extracció de sang, és el mètode que s’ha fet servir.
string
requerit
Marca de temps ISO 8601 de quan es va crear la cita.
string
Marca de temps ISO 8601 de l’última actualització. Pot ser null.
object
requerit
El perfil del pacient associat a aquesta cita.
AppointmentPanel[]
requerit
Panells associats actualment a aquesta cita. Exclou les associacions cancel·lades. Consulta els detalls del panell (nom, biomarcadors) mitjançant Llista els panells.
AppointmentIndividualBiomarker[]
requerit
Biomarcadors a la carta associats a aquesta cita fora de qualsevol panell (consulta Afegeix biomarcadors personalitzats). Contrasta cada biomarker_id amb Llista els biomarcadors per obtenir les dades de visualització.
AppointmentShipmentLink[]
requerit
Enviaments vinculats a aquesta cita, del vincle més antic al més recent. Matriu buida quan no hi ha enviaments vinculats. Creua cada id amb Obtén l’enviament per obtenir les dades completes de l’enviament (estat, número de seguiment, actualitzacions d’estat, etc.).
string[]
requerit
Codis de laboratori (codis de barres dels tubs) registrats per a aquesta cita, per ordre d’escaneig. Buit fins que es confirmi l’extracció de sang. Una extracció venosa porta un sol codi imprès a cada tub; una extracció capil·lar porta un codi per microtub. Els resultats i documents a Obtén els resultats fan referència a aquests codis mitjançant lab_code.

Crides repetides

Aniva desa la resposta d’aquest endpoint durant 15 minuts per a cada clau API. Una crida repetida dins d’aquest temps rep la resposta desada mentre la cita no canviï. Després d’un canvi, reps una resposta nova. Les capçaleres Cache-Status i Age mostren que la resposta està desada i quina antiguitat té. Per assabentar-te d’un canvi a l’instant, subscriu-te als esdeveniments de webhook appointment.created, appointment.rescheduled i a l’esdeveniment de cada estat, per exemple appointment.confirmed. Consulta Lectures repetides.

Respostes d’error