Kendi ürününün içinden kan tahlili randevusu al

Tek bir API anahtarı sana randevudan laboratuvar sonuçlarına kadar 45 uç nokta sunar

Aniva Partner API, Almanya'da 25'ten fazla konumda kan alma randevusu oluşturur, bu randevuya paneller ekler ve klinik ile genetik sonuçları JSON olarak döndürür. Her istek tek bir başlık gerektirir ve temel URL her ortamda aynıdır.

Aniva ne zaman kullanılır

Müşterilerinin kan tahlili randevusuna ihtiyacı olduğunda Aniva'yı kullan
Klinikte kan alma için randevu uç noktalarını, postayla gönderilen kit için evde test kiti uç noktalarını kullan.
Klinik satırlar, genetik satırlar ve PDF raporu için sonuçlar uç noktalarını kullan.
Aniva'nın sattığı biyobelirteçleri, panelleri ve birimleri okumak için katalog uç noktalarını kullan.
https://anivahealth.com/api/v1/ altındaki belgelenmiş yolları kullan ve uç nokta uydurma.
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Temel akış dört istekten oluşur
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

Bugün 45 uç nokta belgelenmiş ve yayında

1

Kimlik doğrulama için yalnızca tek bir istek başlığı gerekir

v1

Her yol v1 ön ekiyle başlar

25+

Almanya'daki noktalar kan alma işlemini yapabilir

Dört istek çalışan bir entegrasyon oluşturur

Randevudan laboratuvar sonuçlarına dört istek gider

Her istek bir sonrakinin ihtiyaç duyduğu ID'yi döndürür; dolayısıyla panelleri, yeniden planlamaları veya kuryeleri eklemeden önce temel bir entegrasyon dört istekten oluşur.

Adım 01 · GET /locations

Anahtarının randevu alabileceği konumları listelersin

Yanıt sana her adresi, çalışma saatlerini ve saat dilimini verir; böylece bir müşteri yalnızca mevcut zaman aralıklarını görür.

Testler
Adım 02 · POST /profiles

Müşteri için bir profil oluşturursun

Bir profil için bir ad, bir cinsiyet kodu, bir doğum tarihi ve bir UUID veya kendi slug'ını kabul eden profile_group alanın gerekir.

Testler
Adım 03 · POST /appointments

Seçtiğin saat diliminde randevunu alırsın

Randevu oluşturmak için profil ID'si, konum ID'si ve saat farkı veya Z eki içeren bir ISO 8601 tarih-saat değeri gerekir.

Testler
Adım 04 · POST /appointments/{id}/confirm

Kan almayı kit barkoduyla onaylarsın

Bu istek laboratuvar siparişini başlatır ve randevuyu kilitler; bu yüzden göndermeden önce tüm panel değişikliklerini yap.

Testler
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Yetenek

Her kaynak grubu tek bir REST koleksiyonudur

Bir klinikte kan alma veya postayla evde test kiti sipariş edebilirsin. Her ikisi de aynı formatta döner; böylece sonuçları okuyan kodu yalnızca bir kez yazarsın.

Profiller · 4 uç nokta

Profil, test ettiğin kişidir

Bir profili e-postayla arar, profil grubunun altında oluşturur ve demografik bilgileri daha sonra güncellersin.

Testler
GET /profiles
PATCH /profiles/{id}
Randevular · 15 uç nokta

Bir randevu, panelleri ve kan almayı içerir

On beş uç nokta; paneller, numune kabı önizlemeleri ve onay dahil olmak üzere randevuyu ve sonrasında yapılan her değişikliği kapsar.

Testler
POST /appointments
GET /appointments/{id}/results
Evde test kiti siparişleri · 10 uç nokta

Evde test kiti siparişleri posta versiyonudur

On uç nokta bir profil için DIY kiti talep eder, panellerini değiştirir ve aynı sonuç yapısını döndürür.

Testler
Kit siparişi oluştur
Sonuçları al
Konumlar · 2 uç nokta

Konumlar sana kan almanın nerede yapıldığını gösterir

Anahtarının randevu alabildiği konumları okursun, ardından bunlardan birinden randevuya uygun zaman dilimi başlangıçlarını istersin.

Testler
GET /locations
GET /locations/{id}/availability
Belgeler · 1 uç nokta

Sonuçlar klinik ve genetik satırlar olarak gelir

Her sipariş türünün kendi sonuç çağrısı vardır ve PDF raporu dosya ID'siyle ayrı olarak indirilir.

Testler
GET /appointments/{id}/results
GET /documents/{id}
Gönderiler · 8 uç nokta

Bir kurye numuneyi laboratuvara götürür

Hafta içi bir alım zaman aralığıyla kurye siparişi oluşturur, ardından randevuları ekler ve durum güncellemelerini okursun.

Testler
POST /shipments
Randevuları ekle
Kataloglar · 4 uç nokta

Kataloglar sipariş edebileceğin biyobelirteçleri listeler

Biyobelirteç, panel ve birim katalogları sayfalandırılmıştır ve biyobelirteçleri test konumuna göre filtreleyebilirsin.

Testler
GET /biomarkers
GET /panels
Sağlık · 1 uç nokta

Bir hazırlık uç noktası API anahtarı gerektirmez

Hazırlık yoklaması API anahtarı gerektirmez, bu yüzden çalışma süresi izleyicin bunu planlı aralıklarla çağırabilir.

Testler
Herkese açık hazırlık kontrolü
İşin barkod onayıyla biter

Kan almayı onayladığında laboratuvar süreci başlar

Bize kit barkodunu gönderirsin ve senden ihtiyacımız olan son şey budur. Sonrasında kapları, kuryeyi ve laboratuvarı biz organize ederiz; böylece rapor hazır olana kadar kodun sadece iki uç noktayı çağırır.

The Aniva lab pipeline from confirmation to results Confirming the draw is followed by container selection, courier collection and laboratory analysis, and each biomarker row then reads as planned, received or fault. POST /appointments/{id}/confirmYou confirm the draw GET /appointments/{id}/previewContainers are known POST /shipmentsA courier collects it Aniva laboratory networkThe laboratory analyses planned received fault GET /appointments/{id}/results
Dolu nokta, istediğin rotadır.Halka, hâlâ senin yönettiğin bir durumdur.Turuncu çizgiler onaylanmış sipariştir.
Tek bir ayrıştırıcı, klinik kan alma ve evde test kitini okur

Her sonucun iki referans aralığı ve dört durumu var

Her klinik satırda laboratuvarın bildirdiği aralık ve optimal penceresiyle birlikte Aniva aralığı yer alır; böylece kendi başvuru tablonu tutmadan ikisini birden gösterebilirsin.

Laboratuvar analiz etmeden önce satırda planlandı yazar.
Bir değer ve bir birim geri döndüğünde satır alındı olarak görünür.
Laboratuvar isteği iptal ettiğinde satırda fault yazar ve status_reason bunun nedenini açıklar.
GET /api/v1/appointments/{id}/results
{
  "status": "in_progress",
  "clinical_results": [{
    "status": "received",
    "biomarker_name": "Vitamin D",
    "value": 38.5, "unit": "ng/mL",
    "reference_range_lab": { "normal_min": 30, "normal_max": 100 },
    "reference_range_aniva": { "optimal_min": 40, "optimal_max": 60 },
    "tested_at": "2026-04-05"
  }],
  "documents": [{ "file_name": "lab-report-2026-04-05.pdf" }]
}
API üç zaman biçimi kullanır

Tarih-saat değerlerinde saat dilimi gerekir, yoksa istek başarısız olur

Saat dilimi belirtilmemiş bir tarih-saat 400 ile reddedilir; bu, çoğu ilk entegrasyonun yaptığı tek hatadır.

Zaman damgaları her zaman Z son ekiyle, ISO 8601 formatında UTC olarak döner.
Girdiler açık bir saat dilimi farkı içermelidir, bu yüzden randevu 2026-05-15T12:30:00+02:00 değerini kabul eder.
Gönderi güncellemeleri, lojistik sağlayıcısının bildirdiği saat farkını korur.
Takvim alanları, doğum tarihi gibi yalnızca saat diliminden bağımsızdır.
Aniva her iş ortağı anahtarını oluşturur ve yeniler

Her istek için iş ortağı API anahtarın gerekir

Kimlik doğrulama her çağrıda x-api-key başlığını kullanır; eksik veya yenilenmiş bir anahtar, kısa bir JSON hatasıyla birlikte 403 döndürür.

Anahtarın hangi konumları, randevuları ve gönderileri görebileceğini belirler.
API anahtarını asla istemci tarafı kodlarında veya herkese açık depolarda açığa çıkarma.
Herkese açık bir yoklama API anahtarı gerektirmez

Her hizmeti durum sayfasından takip edebilirsin

Durum sayfası her hizmetin mevcut durumunu ve 90 günlük geçmişini gösterir; aynı veriler kendi izleme sistemin için JSON olarak da mevcuttur.

İş ortağı anahtarları ekibimiz tarafından verilir

Bugün bizden bir iş ortağı anahtarı iste

Hangi pazarlarda satış yaptığını ve hangi panellere ihtiyacın olduğunu bize bildir, biz de doğru izinlere sahip bir anahtar gönderelim.

OpenAPI dosyasını da indirebilirsin

Bu sayfa bir tasarım taslağıdır. Üzerindeki her endpoint ve payload docs.anivahealth.com adresinden alınmıştır ve akış diyagramı örnek amaçlıdır.

Dokümantasyonun makine tarafından okunabilir kopyaları docs.anivahealth.com/llms.txt ve docs.anivahealth.com/llms-full.txt adreslerinde bulunur.