Unidades
Listar unidades
Explorar o catálogo de unidades de medida
GET
/
api
/
v1
/
units
curl --url 'https://anivahealth.com/api/v1/units' \
--header 'x-api-key: YOUR_API_KEY'
[
{
"id": 1,
"title": "nmol/L",
"display_title": null,
"aliases": ["nmol/l"],
"unit_type": "physical"
},
{
"id": 2,
"title": "mmol/L",
"display_title": null,
"aliases": ["mmol/l", "millimol/L"],
"unit_type": "physical"
},
{
"id": 47,
"title": "ug/dL",
"display_title": "µg/dL",
"aliases": ["µg/dL", "mcg/dL"],
"unit_type": "physical"
}
]
Devolve o catálogo de unidades de medida. O
id numérico mantém-se estável mesmo após alterações de nome — guarda-o ao persistir dados de resultados para que os títulos de apresentação possam ser atualizados sem quebrar a integridade referencial.
Requer o âmbito panels_access.
Vais receber referências unit_id nos payloads de resultados (Obter resultados) e na unidade predefinida de cada biomarcador (Listar biomarcadores). Usa este endpoint para resolver esses IDs para um título de apresentação atual.
Resposta
Devolve um array de unidades.Substituição opcional para apresentação legível.
null significa que não existe substituição — apresenta title tal como está. Só é
preenchido quando o title canónico (que prioriza a leitura automática) difere da
forma preferida para a interface (por ex., ug/dL → µg/dL).Grafias alternativas e sinónimos reconhecidos para esta unidade (por ex.,
["mmol/l", "millimol/L"]).
Exclui o title canónico. Útil para corresponder strings de unidades em texto livre de fontes externas.physical para grandezas mensuráveis (por ex., nmol/L, mg). discrete para valores enumerados/categóricos
(por ex., positivo/negativo). logarithmic para o logaritmo de uma grandeza, como o pH ou um
índice aterogénico: o valor não tem uma escala linear.Respostas de erro
| Estado | Descrição |
|---|---|
403 | Proibido — falta o âmbito panels_access. |
500 | Erro interno do servidor. |
curl --url 'https://anivahealth.com/api/v1/units' \
--header 'x-api-key: YOUR_API_KEY'
[
{
"id": 1,
"title": "nmol/L",
"display_title": null,
"aliases": ["nmol/l"],
"unit_type": "physical"
},
{
"id": 2,
"title": "mmol/L",
"display_title": null,
"aliases": ["mmol/l", "millimol/L"],
"unit_type": "physical"
},
{
"id": 47,
"title": "ug/dL",
"display_title": "µg/dL",
"aliases": ["µg/dL", "mcg/dL"],
"unit_type": "physical"
}
]
⌘I
curl --url 'https://anivahealth.com/api/v1/units' \
--header 'x-api-key: YOUR_API_KEY'
[
{
"id": 1,
"title": "nmol/L",
"display_title": null,
"aliases": ["nmol/l"],
"unit_type": "physical"
},
{
"id": 2,
"title": "mmol/L",
"display_title": null,
"aliases": ["mmol/l", "millimol/L"],
"unit_type": "physical"
},
{
"id": 47,
"title": "ug/dL",
"display_title": "µg/dL",
"aliases": ["µg/dL", "mcg/dL"],
"unit_type": "physical"
}
]