Ana içeriğe atla
POST
Hastanın numunesini aldığını bildir. Bu, Kan almayı onayla uç noktasının evde test kiti karşılığıdır — barkod olmadan, çünkü kitin kodu kit paketlenirken eklenir. Yalnızca numune alma zaman damgasını gönderirsin. Zaman damgası klinik açıdan önemlidir: laboratuvar raporunda yer alacak numune alma zamanıdır. Sisteminin bunu işlediği anı değil, hastanın numuneyi gerçekten aldığı anı gönder. Aynı activated_at değerini tekrar göndermek etkinleştirilen siparişle birlikte 200 döndürür; farklı bir değer göndermek 409 döndürür. Bkz. İdempotans. Etkinleştirme, siparişi nihai bir durum olan activated durumuna geçirir. Etkinleştirilmiş bir sipariş artık iptal edilemez; içeriği ve teslimat adresi kilitlenir. Siparişin bir lab_code değeri olduğu sürece pending veya dispatched durumundayken etkinleştirme kabul edilir — kayıtlarımız gönderildi olarak güncellenmeden önce hasta kiti elinde tutuyor olabilir ve gerçek numune alma zamanı her zaman kayıtlarımızın önündedir. lab_code içermeyen bir sipariş 409 döndürür: kod olmadan numune laboratuvarda hastayla eşleştirilemez. Etkinleştirme, kitin paneli için siparişin lab_code değeri altında laboratuvar siparişini de oluşturur; böylece numune laboratuvarda beklenir ve sonuçlar bildirildiği anda eklenebilir. Bu işlem yanıttan sonra eşzamansız olarak gerçekleşir — bir laboratuvar sorunu isteğini hiçbir zaman başarısız kılmaz. Bu noktadan itibaren Sonuçları al, laboratuvar bildirene kadar belirteçleri planned olarak gösterir. Değiştiklerinde home_kit_order.results.updated webhook’u sana haber verir. Numune, sen kiti etkinleştirmeden önce laboratuvara ulaşırsa kiti Aniva etkinleştirir. activated_at, iade paketinin ilk takip olayının sabahı veya takip bilgisi yoksa numunenin laboratuvara ulaştığı sabahtır. Daha sonra farklı bir activated_at ile yapılan bir çağrı 409 döndürür. home_kit_orders_manage kapsamını veya daha dar olan home_kit_orders_activate kapsamını gerektirir.

İstek

Yol parametreleri

string
gerekli
Etkinleştirilecek evde test kiti siparişinin benzersiz kimliği (UUID).

Gövde parametreleri

string
gerekli
Hastanın numuneyi aldığı UTC zamanı (Z son ekiyle ISO 8601, örn. 2026-08-28T07:30:00Z). Gelecekte veya 30 günden daha geçmişte olmamalıdır.

Yanıt

Başarılı olduğunda API, güncellenmiş evde test kiti siparişiyle 200 OK döndürür — status activated olur ve activated_at gönderdiğin zaman damgasını taşır.

Hata yanıtları