Saltar para o conteúdo principal
POST
Adiciona um ou mais painéis de análise ao sangue a uma marcação existente. Podes chamar este endpoint várias vezes para compor a seleção de painéis antes de confirmares a colheita de sangue. Requer o scope appointments_schedule.
Não é possível adicionar painéis depois de chamares Confirmar colheita de sangue. Tentar adicionar painéis a uma marcação confirmada devolve 409 Conflict.
Numa colheita capilar (draw_method: capillary), a colheita é distribuída por microtainers. Os painéis entram primeiro, por ordem de marcação. Os biomarcadores individuais preenchem depois o espaço livre dos microtainers dos painéis. Quando precisam de mais espaço, abrem novos microtainers. Distribuímo-los de forma uniforme. Cada microtainer comporta no máximo 150 µl de biomarcadores individuais. Se o conjunto resultante de painéis violar esta regra, a chamada devolve 400 com uma mensagem em error e nenhum painel é adicionado.

Pedido

Parâmetros de caminho

string
obrigatório
Identificador único (UUID) da marcação à qual adicionar painéis.

Parâmetros do corpo

string[]
obrigatório
Array de UUIDs de painéis a adicionar à marcação. Tem de conter pelo menos um item.

Resposta

Em caso de sucesso, a API devolve 200 OK a confirmar que os painéis foram adicionados.
boolean
true quando os painéis foram adicionados com sucesso à marcação.

Respostas de erro

Painel de kit de teste em casa

Um kit de teste em casa é enviado ao paciente e a colheita não é feita numa marcação. Se um painel em panel_ids for um kit de teste em casa, a chamada devolve 409 e não adiciona nenhum painel. O corpo tem estes campos:
string
Motivo legível por humanos.
string
Sempre home_kit_appointment_mismatch_error.
string
A marcação à qual o painel não foi adicionado.
string
O painel de kit de teste em casa.
string | null
O fornecedor do kit de teste em casa do painel, ou null quando não é conhecido.