Catalogo dei test
Ottieni biomarcatore
Recupera un singolo biomarcatore tramite 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]
}
]
}
}
Restituisce un singolo biomarcatore tramite il suo
id numerico. Utile per risolvere gli ID restituiti da Elenca pannelli o dai payload degli appuntamenti in dettagli completi (nome, unità, materiale, categoria) senza scorrere l’intero catalogo.
Serve lo stesso catalogo di Elenca biomarcatori, quindi invia la stessa origine. Un biomarcatore archiviato restituisce 404. Lo stesso vale per un biomarcatore che non puoi ordinare da quell’origine con i laboratori che la tua chiave può usare.
Richiede lo scope panels_access. L’oggetto pricing richiede anche lo scope prices_view.
Parametri di percorso
Parametri di query
L’origine può avere due forme: una sede per esami o un kit domiciliare. Inviane esattamente una. Nessuna o entrambe restituiscono400.
- Sede per esami
- Kit domiciliare
Sostituisci il listino prezzi usato da
price_cents: retail, oppure l’id di un listino che la tua chiave può usare. Ottieni listino prezzi restituisce quell’id. Per impostazione predefinita usa il listino dell’account di fatturazione della tua chiave API, altrimenti il listino retail.Risposta
Indica se questo biomarcatore è una misurazione clinica o un marcatore genetico.
Unità di misura predefinita. Usa
id per dereferenziare rispetto a Elenca unità se
hai bisogno di un’identità stabile anche dopo eventuali rinomine.Quanto costa questo biomarcatore e come viene venduto — vedi oggetti
prezzo. È
null solo quando alla tua chiave manca lo
scope prices_view; un biomarcatore a cui Aniva non ha assegnato un prezzo viene comunque restituito, con
pricing.price_cents: null.Risposte di errore
| Stato | Descrizione |
|---|---|
400 | Errore di convalida — id non valido, nessuna origine o due origini, oppure rate_card sconosciuto o non autorizzato. |
403 | Vietato — scope panels_access mancante. |
404 | Biomarcatore non trovato, archiviato o non ordinabile dall’origine. Anche per un location_id sconosciuto. |
500 | Errore interno del server. |
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]
}
]
}
}