Testkatalog
Biomarker abrufen
Einen einzelnen Biomarker anhand der ID abrufen
GET
/
api
/
v1
/
biomarkers
/
{id}
curl --url 'https://anivahealth.com/api/v1/biomarkers/42?home_kit=true' \
--header 'x-api-key: YOUR_API_KEY'
{
"id": 42,
"slug": "vitamin-d-25-oh",
"name": "Vitamin D (25-OH)",
"description": "Serum 25-hydroxyvitamin D …",
"primary_category": "Vitamins",
"secondary_category": null,
"type": "clinical",
"material": "serum",
"unit": { "id": 1, "title": "nmol/L", "display_title": null },
"pricing": {
"price_cents": 3952,
"retail_cents": 4549,
"tier": "specialty"
}
}
{
"id": 77,
"slug": "mean-platelet-volume",
"name": "Mean Platelet Volume (MPV)",
"description": null,
"primary_category": "Haematology",
"secondary_category": null,
"type": "clinical",
"material": "whole_blood",
"unit": { "id": 7, "title": "fL", "display_title": null },
"pricing": {
"price_cents": 0,
"retail_cents": 0,
"positions": [
{
"id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
"name": "Blood Count (extended)",
"price_cents": 460,
"retail_cents": 529,
"biomarker_ids": [71, 72, 73, 77],
"includes": [71, 72, 73]
}
]
}
}
Gibt einen einzelnen Biomarker anhand seiner numerischen
id zurück. Nützlich, um die von Panels auflisten oder in Termin-Payloads zurückgegebenen IDs in vollständige Details (Name, Einheit, Material, Kategorie) aufzulösen, ohne den gesamten Katalog zu durchsuchen.
Der Endpunkt liefert denselben Katalog wie Biomarker auflisten, sende also dieselbe Herkunft. Ein archivierter Biomarker gibt 404 zurück. Dasselbe gilt für einen Biomarker, den du für diese Herkunft nicht über die Labore bestellen kannst, die dein Schlüssel nutzen darf.
Erfordert den Scope panels_access. Für das pricing-Objekt ist zusätzlich der Scope prices_view erforderlich.
Pfadparameter
Query-Parameter
Die Herkunft hat eine von zwei Formen: ein Teststandort oder ein Heimtest-Kit. Sende genau eine. Keine oder beide geben400 zurück.
- Teststandort
- Heimtest-Kit
Überschreibe, welche Preisliste
price_cents verwendet: retail oder die id einer Preisliste, die dein Schlüssel nutzen darf. Preisliste abrufen gibt diese id zurück. Standardmäßig gilt die Preisliste des Abrechnungskontos deines API-Schlüssels, sonst die Endkunden-Preisliste.Antwort
Gibt an, ob dieser Biomarker ein klinischer Messwert oder ein genetischer Marker ist.
Standard-Maßeinheit. Nutze
id zum Abgleich mit Einheiten auflisten, wenn du eine stabile Identität über Umbenennungen hinweg brauchst.Was dieser Biomarker kostet und wie er verkauft wird – siehe Preisobjekte.
null nur, wenn deinem Schlüssel der Scope prices_view fehlt; ein Biomarker, für den Aniva keinen Preis festgelegt hat, wird trotzdem zurückgegeben, mit pricing.price_cents: null.Fehlerantworten
| Status | Beschreibung |
|---|---|
400 | Validierungsfehler – ungültige id, keine oder zwei Herkunftsangaben oder unbekannte/nicht autorisierte rate_card. |
403 | Zugriff verweigert – Scope panels_access fehlt. |
404 | Biomarker nicht gefunden, archiviert oder für diese Herkunft nicht bestellbar. Auch bei unbekannter location_id. |
500 | Interner Serverfehler. |
curl --url 'https://anivahealth.com/api/v1/biomarkers/42?home_kit=true' \
--header 'x-api-key: YOUR_API_KEY'
{
"id": 42,
"slug": "vitamin-d-25-oh",
"name": "Vitamin D (25-OH)",
"description": "Serum 25-hydroxyvitamin D …",
"primary_category": "Vitamins",
"secondary_category": null,
"type": "clinical",
"material": "serum",
"unit": { "id": 1, "title": "nmol/L", "display_title": null },
"pricing": {
"price_cents": 3952,
"retail_cents": 4549,
"tier": "specialty"
}
}
{
"id": 77,
"slug": "mean-platelet-volume",
"name": "Mean Platelet Volume (MPV)",
"description": null,
"primary_category": "Haematology",
"secondary_category": null,
"type": "clinical",
"material": "whole_blood",
"unit": { "id": 7, "title": "fL", "display_title": null },
"pricing": {
"price_cents": 0,
"retail_cents": 0,
"positions": [
{
"id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
"name": "Blood Count (extended)",
"price_cents": 460,
"retail_cents": 529,
"biomarker_ids": [71, 72, 73, 77],
"includes": [71, 72, 73]
}
]
}
}
⌘I
curl --url 'https://anivahealth.com/api/v1/biomarkers/42?home_kit=true' \
--header 'x-api-key: YOUR_API_KEY'
{
"id": 42,
"slug": "vitamin-d-25-oh",
"name": "Vitamin D (25-OH)",
"description": "Serum 25-hydroxyvitamin D …",
"primary_category": "Vitamins",
"secondary_category": null,
"type": "clinical",
"material": "serum",
"unit": { "id": 1, "title": "nmol/L", "display_title": null },
"pricing": {
"price_cents": 3952,
"retail_cents": 4549,
"tier": "specialty"
}
}
{
"id": 77,
"slug": "mean-platelet-volume",
"name": "Mean Platelet Volume (MPV)",
"description": null,
"primary_category": "Haematology",
"secondary_category": null,
"type": "clinical",
"material": "whole_blood",
"unit": { "id": 7, "title": "fL", "display_title": null },
"pricing": {
"price_cents": 0,
"retail_cents": 0,
"positions": [
{
"id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
"name": "Blood Count (extended)",
"price_cents": 460,
"retail_cents": 529,
"biomarker_ids": [71, 72, 73, 77],
"includes": [71, 72, 73]
}
]
}
}