Saltar al contenido principal
Usa esta guía para encontrar un centro de pruebas, crear una cita para el perfil de un paciente y asociar los paneles de pruebas que se realizarán. Completa estos pasos antes de que el paciente acuda a su extracción de sangre.
1

Consultar los centros disponibles

Obtén la lista de centros de pruebas disponibles en tu cuenta enviando una solicitud GET a /api/v1/locations.
La respuesta es un array de objetos de centro:
Usa el campo timezone del objeto de centro al construir la marca de tiempo scheduled_at. Convertir la hora de la cita a la zona horaria local del centro te ayuda a evitar programar fuera del horario de apertura.
No calcules los horarios reservables únicamente a partir de open_hours. Llama a Obtener disponibilidad y reserva una hora de inicio de franja que devuelva: esa cuadrícula también tiene en cuenta las reservas existentes, las excepciones por fecha y la antelación mínima.
2

Crear la cita

Envía una solicitud POST a /api/v1/appointments con el ID del perfil, el ID del centro y la hora de cita deseada. La hora debe ser una hora de inicio de franja de Obtener disponibilidad.
scheduled_at debe ser una fecha y hora futura en formato ISO 8601, por ejemplo 2026-05-12T07:30:00Z. Las marcas de tiempo en el pasado se rechazan con un error 400, al igual que las horas dentro del plazo de antelación mínima de 12 horas en los centros gestionados por Aniva.
Repetir esta solicitud es seguro. Un perfil solo puede tener una cita por centro y hora, por lo que una solicitud de creación reenviada o duplicada devuelve 409 con el appointment_id existente en lugar de reservar dos veces al paciente.
Una solicitud correcta devuelve 201 Created con el objeto de cita:
Guarda el id de la cita: lo necesitarás para añadir paneles y confirmar la extracción de sangre.
3

Añadir paneles de pruebas

Asocia los paneles de pruebas que quieres realizar en la muestra de sangre enviando una solicitud POST a /api/v1/appointments/{id}/panels.Los ID de los paneles son UUID. Llama a Listar paneles para obtener los paneles que tu clave de API puede solicitar.
No se pueden añadir paneles después de haber confirmado la extracción de sangre. Añade todos los paneles necesarios antes de la confirmación; consulta Confirmar extracción de sangre para más detalles.
Una solicitud correcta devuelve 200 OK confirmando que se han añadido los paneles:

Reprogramar o cancelar

Después de crear una cita, aún puedes modificarla antes de que se confirme la extracción de sangre:
  • Reprogramar o cambiar de centro: envía una solicitud PATCH a /api/v1/appointments/{id} con los campos que quieras actualizar. Consulta Actualizar cita.
  • Cancelar: envía una solicitud DELETE a /api/v1/appointments/{id}. Consulta Cancelar cita.
Ambas operaciones solo están disponibles antes de la extracción de sangre, es decir, mientras la cita esté en estado pending o confirmed. Una vez que la cita pasa a blood_drawn, no es posible realizar más modificaciones.

Gestión de errores