Saltar al contingut principal
Aquesta guia et mostra el flux de treball principal: trobar un centre de proves, crear un perfil de pacient, programar una cita i confirmar una extracció de sang.

Requisits previs

Necessites una clau d’API de col·laborador emesa per Aniva.
Si encara no tens una clau d’API, contacta amb Aniva perquè n’emeti una per al teu compte de col·laborador.

Passos

1

Llista els centres disponibles

Consulta la llista de centres de proves per trobar un location_id per a la cita que programaràs.
Exemple de resposta
Anota l’id del centre que vols utilitzar. El necessitaràs al pas 3.
2

Crea un perfil

Crea un perfil de pacient enviant-ne les dades demogràfiques. El camp profile_group vincula el perfil al teu compte de col·laborador: accepta tant l’UUID immutable del grup com el seu slug llegible.
Camps del cos de la petició** Opcional quan el teu grup de perfils permet al pacient introduir totes dues dades a la pàgina d’activació del kit. Consulta Perfils.Exemple de resposta (201 Created)
Anota l’id de la resposta. L’utilitzaràs com a profile_id al pas següent.
3

Programa una cita

Crea una cita amb el profile_id del pas 2 i el location_id del pas 1. Assigna a scheduled_at l’inici d’una franja retornada per Obtén la disponibilitat per a aquell centre. L’API rebutja qualsevol hora que no coincideixi amb la graella de franges.
Exemple de resposta (201 Created)
Anota l’id de la cita. L’utilitzaràs per confirmar l’extracció de sang.
4

Confirma l'extracció de sang

Un cop completada l’extracció de sang, envia el codi de laboratori (codi de barres del tub) per confirmar l’extracció i activar el flux de comandes de laboratori. Si els tubs d’una extracció porten diversos codis, envia lab_codes en lloc d’això — consulta Confirma l’extracció de sang.
Exemple de resposta (200 OK)
Un cop confirmada, s’activa el flux de comandes de laboratori. Pots consultar la cita per comprovar que el seu estat ha canviat a "blood_drawn".

Passos següents