Saltar al contingut principal
Fes servir aquesta guia per trobar un centre de proves, crear una cita per a un perfil de pacient i afegir els panells de proves que cal analitzar. Completa aquests passos abans que el pacient arribi a la seva extracció de sang.
1

Consulta els centres disponibles

Obtén la llista de centres de proves disponibles al teu compte enviant una petició GET a /api/v1/locations.
La resposta és una matriu d’objectes de centre:
Fes servir el camp timezone de l’objecte del centre quan construeixis la marca de temps scheduled_at. Convertir l’hora de la cita al fus horari local del centre t’ajuda a evitar programar fora de l’horari d’obertura.
No dedueixis els horaris reservables només a partir de open_hours. Crida Obtén la disponibilitat i reserva l’inici d’una franja que retorni — aquesta graella també té en compte les reserves existents, les excepcions per data i l’antelació mínima.
2

Crea la cita

Envia una petició POST a /api/v1/appointments amb l’ID del perfil, l’ID del centre i l’hora desitjada per a la cita. L’hora ha de ser l’inici d’una franja retornada per Obtén la disponibilitat.
scheduled_at ha de ser una data i hora futura en format ISO 8601, per exemple 2026-05-12T07:30:00Z. Les marques de temps passades es rebutgen amb un error 400, igual que les hores dins de l’antelació mínima de 12 hores als centres gestionats per Aniva.
Repetir aquesta petició és segur. Un perfil només pot tenir una cita per centre i hora, de manera que una creació reenviada o duplicada retorna 409 amb l’appointment_id existent en lloc de reservar dues vegades per al pacient.
Una petició correcta retorna 201 Created amb l’objecte de la cita:
Desa l’id de la cita — el necessitaràs per afegir panells i confirmar l’extracció de sang.
3

Afegeix panells de proves

Afegeix els panells de proves que vulguis analitzar a la mostra de sang enviant una petició POST a /api/v1/appointments/{id}/panels.Els ID dels panells són UUID. Crida Llista els panells per obtenir els panells que pot demanar la teva clau API.
No es poden afegir panells després d’haver confirmat l’extracció de sang. Afegeix tots els panells necessaris abans de la confirmació — consulta Confirma l’extracció de sang per obtenir-ne més detalls.
Una petició correcta retorna 200 OK per confirmar que els panells s’han afegit:

Reprogramació o cancel·lació

Després de crear una cita, encara la pots modificar abans que es confirmi l’extracció de sang:
  • Reprograma o canvia de centre — Envia una petició PATCH a /api/v1/appointments/{id} amb els camps que cal actualitzar. Consulta Actualitza la cita.
  • Cancel·la — Envia una petició DELETE a /api/v1/appointments/{id}. Consulta Cancel·la la cita.
Totes dues operacions només estan disponibles abans de l’extracció de sang — és a dir, mentre la cita està en estat pending o confirmed. Un cop la cita passa a blood_drawn, ja no es poden fer més modificacions.

Gestió d’errors