Testkatalog
Hent biomarkør
Hent en enkelt biomarkør via ID
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]
}
]
}
}
Returnerer en enkelt biomarkør ud fra dens numeriske
id. Nyttig til at omsætte de ID’er, der returneres af Vis paneler eller payloads for tider, til fulde detaljer (navn, enhed, materiale, kategori) uden at gennemgå hele kataloget.
Den bruger det samme katalog som Vis biomarkører, så send den samme oprindelse. En arkiveret biomarkør returnerer 404. Det samme gør en biomarkør, du ikke kan bestille for den oprindelse hos de laboratorier, din nøgle må bruge.
Kræver panels_access-scope. Objektet pricing kræver også prices_view-scope.
Path-parametre
Query-parametre
Oprindelsen har én af to former: en testlokation eller et hjemmetestkit. Send præcis én. Ingen eller begge returnerer400.
- Testlokation
- Hjemmetestkit
Tilsidesæt, hvilken prisliste
price_cents bruger: retail, eller id for en prisliste, din nøgle må bruge. Hent prisliste returnerer det id. Bruger som standard prislisten på din API-nøgles faktureringskonto, ellers detailprislisten.Svar
Standardmåleenhed. Brug
id til at slå op mod Vis enheder, hvis du har
brug for stabil identitet på tværs af navneændringer.Hvad denne biomarkør koster, og hvordan den sælges — se
prisobjekter. Kun
null, når din nøgle
mangler prices_view-scope; en biomarkør, Aniva ikke har prissat, returneres stadig med
pricing.price_cents: null.Fejlsvar
| Status | Beskrivelse |
|---|---|
400 | Valideringsfejl — ugyldigt id, ingen eller to oprindelser, eller ukendt/uautoriseret rate_card. |
403 | Forbudt — manglende panels_access-scope. |
404 | Biomarkør ikke fundet, arkiveret eller kan ikke bestilles for oprindelsen. Også ved ukendt location_id. |
500 | Intern serverfejl. |
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]
}
]
}
}