GET /{numero}/getAnimalPorNumero

Retorna os dados de um animal usando seu número de rastreabilidade (chave natural) em vez do UUID interno.

Campo	Valor
Método	GET
Endpoint	/animal/{numero}/getAnimalPorNumero
Chave Natural	numero (String)
Parâmetro substituído	id (UUID)
Fachada para	GET /animal/{id}

Parâmetros de Path

Nome	Tipo	Obrigatório	Descrição
numero	String	✅	Número de identificação/rastreabilidade do animal

Respostas

Código	Descrição
200	Animal encontrado com sucesso
404	Animal não localizado com o número informado
417	Erro interno durante a execução

Exemplo de uso (curl)

curl -X GET https://<api_url>/animal/123456/getAnimalPorNumero \
  -H "Authorization: Bearer {TOKEN}"

Resposta de sucesso (200)

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "numero": "123456",
  "sexo": "MA",
  "codigoRaca": "01",
  "dataNascimento": "2022-05-10"
}

Resposta de erro — Animal não encontrado (404)

{
  "message": "Animal não localizado: 123456"
}