Einheiten
Einheiten auflisten
Den Katalog der Maßeinheiten durchsuchen
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"
}
]
Gibt den Katalog der Maßeinheiten zurück. Die numerische
id bleibt auch bei Umbenennungen stabil – speichere sie, wenn du Ergebnisdaten speicherst, damit Anzeigetitel aktualisiert werden können, ohne die referenzielle Integrität zu verletzen.
Erfordert den Scope panels_access.
Du erhältst unit_id-Referenzen in Ergebnis-Payloads (Ergebnisse abrufen) und bei der Standardeinheit jedes Biomarkers (Biomarker auflisten). Nutze diesen Endpunkt, um diese IDs in einen aktuellen Anzeigetitel aufzulösen.
Antwort
Gibt ein Array von Einheiten zurück.Optionale, lesefreundliche Anzeige-Überschreibung.
null bedeutet, es gibt keine Überschreibung – stelle title unverändert dar. Wird nur
befüllt, wenn der kanonische title (der auf Maschinenlesbarkeit ausgelegt ist) von der
bevorzugten UI-Form abweicht (z. B. ug/dL → µg/dL).Alternative Schreibweisen und Synonyme, die für diese Einheit erkannt werden (z. B.
["mmol/l", "millimol/L"]).
Enthält nicht den kanonischen title. Nützlich zum Abgleichen von Freitext-Einheiten aus externen Quellen.physical für messbare Größen (z. B. nmol/L, mg). discrete für aufgezählte/kategoriale
Werte (z. B. positiv/negativ). logarithmic für den Logarithmus einer Größe, wie pH oder ein
atherogener Index: Der Wert hat keine lineare Skala.Fehlerantworten
| Status | Beschreibung |
|---|---|
403 | Zugriff verweigert – fehlender Scope panels_access. |
500 | Interner Serverfehler. |
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"
}
]