1
Explorar locais disponíveis
Obtém a lista de locais de teste disponíveis na tua conta enviando um pedido A resposta é um array de objetos de local:
GET para /api/v1/locations.2
Criar a marcação
Envia um pedido Um pedido bem-sucedido devolve Guarda o
POST para /api/v1/appointments com o ID do perfil, o ID do local e a hora pretendida para a marcação. A hora tem de corresponder a uma hora de início devolvida por Obter disponibilidade.scheduled_at tem de ser uma data e hora futura no formato ISO 8601, por exemplo 2026-05-12T07:30:00Z. Timestamps no passado são rejeitados com um erro 400, assim como horários dentro da antecedência mínima de 12 horas em locais geridos pela Aniva.201 Created com o objeto da marcação:id da marcação — vais precisar dele para adicionar painéis e confirmar a colheita de sangue.3
Adicionar painéis de análise
Associa os painéis de análise que queres realizar na amostra de sangue enviando um pedido Um pedido bem-sucedido devolve
POST para /api/v1/appointments/{id}/panels.Os IDs dos painéis são UUIDs. Chama Listar painéis para obter os painéis que a tua chave API pode pedir.200 OK, confirmando que os painéis foram adicionados:Reagendar ou cancelar
Depois de criares uma marcação, ainda a podes modificar antes de a colheita de sangue ser confirmada:- Reagendar ou alterar o local — Envia um pedido
PATCHpara/api/v1/appointments/{id}com os campos a atualizar. Consulta Atualizar marcação. - Cancelar — Envia um pedido
DELETEpara/api/v1/appointments/{id}. Consulta Cancelar marcação.
Ambas as operações só estão disponíveis antes da colheita de sangue — ou seja, enquanto a
marcação estiver no estado
pending ou confirmed. Assim que a marcação passar para
blood_drawn, não são possíveis mais modificações.