Saltar para o conteúdo principal
POST
Associa uma ou mais marcações a este envio. Idempotente — as marcações já associadas são ignoradas silenciosamente. A regra de alteração (por marcação) é: a associação pode ser criada quando
  • a marcação já passou pela colheita de sangue (blood_drawn), ou
  • o envio foi criado há menos de 24 horas.
Fora dessa janela, o pedido é rejeitado com 409 Conflict para que os registos históricos se mantenham estáveis. A mesma regra controla Desassociar marcações do envio. Estes dois endpoints são a única forma de alterar associações. A API de marcações não tem um endpoint espelho.

Pedido

Parâmetros de caminho

string
obrigatório
ID de referência do envio (por ex., P2611194821).

Parâmetros do corpo

string[]
obrigatório
Array de UUIDs de marcações a associar. Tem de conter pelo menos um elemento.

Resposta

Em caso de sucesso, a API devolve 200 OK com as marcações associadas no teu contexto de acesso, com a associação mais antiga primeiro. Cada entrada tem a mesma estrutura de Obter marcação.

Respostas de erro