AnpherosAnpheros PlatformDevelopers

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Laboratuvar Bağlayıcısı

Tüm laboratuvar raporunu CSV, HL7 v2 ORU^R01 veya JSON olarak gönderin ve LOINC kodları ve referans aralıklarıyla laboratuvar Gözlemleri alın.

Bir laboratuvar (veya laboratuvar raporu tutan herhangi biri) tüm raporu tek bir istekte gönderir ve platform her bir sonucu hastanın bir laboratuvarı Observation haline getirir:

POST /v1/patients/{patient_id}/labs/import
Authorization: Bearer <project key>
Content-Type: text/csv | x-application/hl7-v2+er7 | application/json
X-Anpheros-Source-System: labx        (optional; recorded in Provenance)
Idempotency-Key: <report id>          (optional; a retry returns the same answer)

Formatlar

CSV başlık satırı ile; ayırıcılar , ; veya sekme, ondalık virgül kabul edilir, tarihler ISO, DD.MM.YYYY veya DD/MM/YYYY. Tanınan sütunlar (Rumence veya İngilizce): işaretleyici (analiza, test, marker, name) — veya yalnızca bir LOINC code sütunu, bu durumda LOINC adı işaretleyici olur — değer (rezultat, valoare, value, result), birim (um, unitate, unit), referans aralığı (interval, referinta: 70-100, <5, >3.5) veya ref_low/ref_high, tarih (data, recoltare), isteğe bağlı LOINC (loinc, code), not.

Analiza;Rezultat;UM;Interval de referinta;Data
Hemoglobina glicozilata (HbA1c);6,4;%;4,0-5,6;01.09.2026
TSH;2,1;mUI/L;0,4-4,0;01.09.2026

HL7 v2 ORU^R01 (ER7 metni, segmentler CR veya LF ile ayrılmış): OBX-3 tanımlayıcı (code^text^LN LOINC'dir; yerel bir kod (^L, ^99zzz) veya başka herhangi bir kodlama sistemi, laboratuvarın kendi kodu olarak saklanır urn:anpheros:lab-code), OBX-5 değer (NM, SN veya metin), OBX-6 birim, OBX-7 referans aralığı, OBX-8 anormal bayrak → interpretation, OBX-11 durum, OBX-14 veya OBR-7 tarih; OBR-3/MSH-10, Provenance'da rapor kimliği olur.

Laboratuvar. Her sonuç, HL7 Europe Laboratory Report 2.1.0'ın gerektirdiği gibi performer'da kimin ürettiğini belirtir: kuruluş (X-Anpheros-Acting-As), aksi takdirde HL7 için MSH-4 (gönderen tesis) veya JSON'da laboratory (üst düzey veya öğe başına). Bir CSV laboratuvar taşımaz; bu tür sonuçlar eksik performansla doğrulanır, ki bu gerçektir.

Metin raporları, belgeler ve eksik tarihler. Bir metin raporu, her satır bir OBX (TX/FT, aynı OBX-3) olarak gönderilir, satırlar birleştirilerek tek bir sonuç olur. OBX-5'daki (ED veya Base64 olarak kodlanmış herhangi bir değer) tam bir belge bir sonuç olarak saklanmaz; yanıt uyarır ve belge /documents'a aittir. OBR-7 olmadan, sonuçlar OBR-14 (numune alındı) tarafından tarihlendirilir ve bir uyarı ile.

Saatler ve saat dilimleri. Saat dilimi olmayan bir v2 saati, UTC değil, gönderenin yerel saatidir. OBX-14/OBR-7 (20260901081000+0300) ile gönderilen ofset saklanır (2026-09-01T08:10:00+03:00). Biri olmadan, MSH-7'nın ofseti kullanılır ve bir uyarı bunu belirtir; hiçbir ofset olmadan, sonuç yalnızca tarihini saklar, bu da bir uyarı ile birlikte gelir. CSV saatleri (01.09.2026 08:10) saat dilimi taşımaz, bu nedenle yalnızca tarih olarak saklanır. 17 Ekim 2026'ya kadar bu saatler UTC olarak etiketlenmişti; o zaman içe aktarılan sonuçlar tanımlayıcılarını korur ve bir rapor tekrar gönderildiğinde hala tanınır.

Hala bekleyen (OBX-11 I), elde edilemeyen (X), silinmiş (D) veya yanlış (W) HL7 sonuçları ve değeri olmayan OBX segmentleri Gözlemler olmaz; her biri warnings'de adlandırılır.

JSON: {"date": "2026-09-01", "origin": "report-77", "laboratory": "Synevo", "items": [{"marker": "TSH", "value": 2.1, "unit": "mUI/L", "ref_low": 0.4, "ref_high": 4.0, "date": "2026-09-01", "code": "3016-3"}]}.

Geri Döndürülenler

{"created": 3, "skipped": 0, "unmapped": ["Marker foarte rar"], "warnings": [],
 "observations": [{"id": "…", "marker": "TSH", "code": "3016-3", "system": "http://loinc.org", "value": 2.1, "unit": "mUI/L", "date": "2026-09-01"}]}

Her iki SDK: labs.importCsv, labs.importHl7, labs.importItems.

Bir CSV ve bir HL7 v2 raporundan FHIR Gözlemlerine, eşlenmemiş işaretleyiciler ve yeniden gönderilen raporlarla çalışılmış bir örnek: Laboratuvar sonuçlarını bir FHIR kaydına nasıl aktarılır.

Laboratuvar verileri laboratuvarlar, klinikler, uygulamalar ve yapay zeka arasında nasıl hareket eder ve bir laboratuvar sonuçları API'sinde nelere dikkat edilmelidir: Laboratuvar Sonuçları API'si.

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Product updates by email

New features, guides and the end of the beta. One email a month at most.

Send me occasional Anpheros Platform updates by email (new features, API changes, guides). I'll confirm by email and can unsubscribe in one click from any email. Privacy