{"openapi":"3.1.0","info":{"title":"Cú Thông Thái Med 3.0 Telemetry & Verification Reference API","description":"Machine-readable OpenAPI 3.1 specification for Medicine 3.0 Telemetry SSoT biomarkers (19 core + 92 dictionary), Zone 2 / HRV Sensor Calibrator, Inside-Out Rejuvenation & Oncology Barbell Triage Gates, and Stage-3 Verified US Reference Laboratories (MED3-125). Curated by Kỹ Sư Trưởng Bách (Phạm Nguyễn Bách / Bach Pham — Patient Zero) at CTCP Tập đoàn Quản lý Tài sản Cú Thông Thái (Cu Thong Thai Asset Management Group JSC).","version":"5.2","contact":{"name":"Kỹ Sư Trưởng Bách (Phạm Nguyễn Bách / Bach Pham)","url":"https://suckhoe.cuthongthai.vn"},"license":{"name":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://suckhoe.cuthongthai.vn","description":"Production Telemetry & Verification Server"}],"paths":{"/api/v1/reference/biomarkers":{"get":{"summary":"Tra cứu Thư viện Chỉ số Viễn trắc Y Học 3.0 (19 Core / 92 Dictionary)","description":"Truy xuất danh mục 19 gói chỉ số viễn trắc lõi hoặc toàn bộ 92 chỉ số (?scope=dictionary) kèm bộ phân giải alias thông minh (?key=apoe -> apoe_gene, ?key=cac -> ct_cac, ?key=mmp1_rs1799750, ?key=cystatinC) và trường chuẩn INV-2.","operationId":"getBiomarkers","parameters":[{"name":"scope","in":"query","required":false,"description":"Chế độ danh mục: mặc định trả 19 gói lõi; truyền scope=dictionary trả đủ 92 chỉ số biomarker","schema":{"type":"string","enum":["core19","dictionary"],"default":"core19"}},{"name":"category","in":"query","required":false,"description":"Lọc chỉ số theo danh mục viễn trắc (core, secondary, imaging, genetic)","schema":{"type":"string","enum":["core","secondary","imaging","genetic"]}},{"name":"key","in":"query","required":false,"description":"Mã biomarker hoặc alias chuẩn hóa (ví dụ: apob, apoe, cac, mmp1_rs1799750, cystatinC, ionizedCalcium, ck, hrv, vo2max)","schema":{"type":"string"},"examples":{"apob":{"value":"apob","summary":"Canonical core key"},"apoeAlias":{"value":"apoe","summary":"Alias resolved to apoe_gene"},"mmp1Variant":{"value":"mmp1_rs1799750","summary":"92-dictionary collagenase SNP"},"cystatinC":{"value":"cystatinC","summary":"92-dictionary renal marker"}}}],"responses":{"200":{"description":"Danh sách các chỉ số viễn trắc tham chiếu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiomarkerApiResponse"}}}},"400":{"description":"Tham số danh mục không hợp lệ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Không tìm thấy biomarker với key được yêu cầu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/api/v1/reference/partners":{"get":{"summary":"Verified Stage-3 Official B2B Reference Laboratories & Chain-of-Custody Registry","description":"Returns exclusively Stage-3 signed official laboratory and institutional partners verified under MED3-125 governance, with multilingual support (vi, en, de, ar) and zero disclosure of Stage-1/2 candidates.","operationId":"getVerifiedPartners","parameters":[{"name":"domain","in":"query","required":false,"description":"Filter Stage-3 partners by analytical or clinical domain","schema":{"type":"string","enum":["epigenetics","botanical_isomeric","heavy_metals_pharmacopeia","precision_oncology","turnkey_cgmp"]}},{"name":"id","in":"query","required":false,"description":"Exact Stage-3 partner identifier (returns uniform 404 for non-Stage-3 IDs)","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Response localization language (defaults to en for international M2M)","schema":{"type":"string","enum":["vi","en","de","ar"],"default":"en"}}],"responses":{"200":{"description":"Stage-3 verified partner dossiers and MED3-125 governance summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifiedPartnersApiResponse"}}}},"400":{"description":"Invalid domain filter parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Uniform 404 when partner ID is not an active Stage-3 official partner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/api/v1/reference/zone2-calibrator":{"get":{"summary":"Zone 2 Manual Modality & Wearable HRV Sensor Calibrator (V5.2)","description":"Computes individualized Tanaka HRmax and posture-specific Zone 2 BPM bounds (Spin Bike vs Treadmill Incline/Rucking 10kg), flags watchOS Auto-Karvonen %HRR trap (>= 135 BPM), and contrasts Oura Ring rMSSD (>= 40 ms) vs Apple Watch SDNN (>= 48 ms).","operationId":"calibrateZone2AndWearable","parameters":[{"name":"age","in":"query","required":false,"description":"Chronological age in years (default 43 reference)","schema":{"type":"integer","example":43}},{"name":"modality","in":"query","required":false,"description":"Cardiorespiratory training modality","schema":{"type":"string","enum":["spin_bike","treadmill_incline","rucking_10kg","swimming","outdoor_walk"],"default":"spin_bike"}},{"name":"restingHr","in":"query","required":false,"description":"Sleeping resting heart rate in BPM (default 51)","schema":{"type":"number","example":51}}],"responses":{"200":{"description":"Zone 2 manual bounds, Karvonen trap warning, and HRV sensor comparison","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Zone2CalibrationApiResponse"}}}},"400":{"description":"Invalid cardiorespiratory modality parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/api/oncology/triage":{"post":{"summary":"Wave 5 Precision Oncology Barbell & 3-Step Heavy-Ion Physics Triage Gate","description":"Evaluates 2-Head Oncology Barbell routing, Streck cfDNA BCT® (6°C–37°C, 0% freeze) pre-analytical integrity, 3-Step International Precision Gate (CGP -> Step 2A DICOM -> Step 2B Hospital Second Opinion -> Carbon-Ion/Proton/BNCT/ADC/mRNA), Guard #13 72h Cool-Off & MED3-125 air-gap.","operationId":"postOncologyBarbellTriage","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Oncology Barbell triage evaluation payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriageApiResponse"}}}},"400":{"description":"Invalid JSON or schema validation failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/api/rejuvenation/triage":{"post":{"summary":"Inside-Out Structural Rejuvenation & Collagen/PBM Triage Gate","description":"Evaluates MMP1 rs1799750 collagenase risk, HbA1c AGEs/PIH gate (< 5.5% before Medical CIT), Mandibular Hungry Bone gate (Ca2+ >= 1.15 mmol/L), Zero-EMF 0.0 uT Arndt-Schulz PBM (630/660nm) & Scale 2 PDL 595nm routing.","operationId":"postInsideOutRejuvenationTriage","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Inside-Out rejuvenation evaluation payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriageApiResponse"}}}},"400":{"description":"Invalid JSON or schema validation failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/.well-known/agent.json":{"get":{"summary":"A2A Agent Discovery Manifest (KYB & Autonomous Agent Verification Card)","description":"Machine-readable A2A agent discovery manifest exposing corporate legal identity SSoT, 13-Specialist Council summary, 5 skills, OpenAPI, and llms.txt links.","operationId":"getAgentDiscoveryManifest","responses":{"200":{"description":"A2A Agent Discovery Manifest v1.0 (Node v5.2)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDiscoveryManifest"}}}}}}}},"components":{"schemas":{"BiomarkerCitation":{"type":"object","required":["author","title","journalOrSource","year"],"properties":{"author":{"type":"string"},"title":{"type":"string"},"journalOrSource":{"type":"string"},"year":{"type":"integer"},"doiOrUrl":{"type":"string","format":"uri"},"pmid":{"type":"string"}}},"BiomarkerReference":{"type":"object","required":["key","nameVi","nameEn","category","unit","med2Range","med3Target","ontology","cadence","clinicalRationale","citations"],"properties":{"key":{"type":"string"},"nameVi":{"type":"string"},"nameEn":{"type":"string"},"category":{"type":"string","enum":["core","secondary","imaging","genetic"]},"unit":{"type":"string"},"med2Range":{"type":"string"},"med3Target":{"type":"string"},"ontology":{"type":"string","enum":["PERCENTILE","ABSOLUTE_THRESHOLD","BINARY"]},"cadence":{"type":"string","enum":["quarterly","annual","lifetime"]},"formula":{"oneOf":[{"type":"string"},{"type":"null"}]},"clinicalRationale":{"type":"string"},"citations":{"type":"array","items":{"$ref":"#/components/schemas/BiomarkerCitation"}},"med2_hospital_reference":{"type":"string","description":"INV-2 Dual-Track Med 2.0 hospital clinical reference range"},"med3_optimal_target":{"type":"string","description":"INV-2 Dual-Track Med 3.0 proactive Top 5% Elite target"},"ontology_type":{"type":"string","enum":["PERCENTILE","ABSOLUTE_THRESHOLD","BINARY"]}}},"BiomarkerApiResponse":{"type":"object","required":["status","version","total","data"],"properties":{"status":{"type":"string","example":"success"},"version":{"type":"string","example":"5.2"},"license":{"type":"string","example":"CC-BY-4.0"},"specification":{"type":"string","example":"Medicine 3.0 Telemetry SSoT (Cú Thông Thái Health)"},"timestamp":{"type":"string","format":"date-time"},"total":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/BiomarkerReference"}},"error":{"oneOf":[{"type":"string"},{"type":"null"}],"example":null},"meta":{"type":"object","properties":{"version":{"type":"string"},"total":{"type":"integer"},"license":{"type":"string"},"specification":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"scope":{"type":"string","enum":["core_19","dictionary_92"]}}},"VerifiedPartnerDossier":{"type":"object","required":["partnerId","displayName","displayNameVi","displayNameEn","legalEntityName","domainKey","domainLabel","countryCode","headquarters","officialWebsite","activatedIdentifierBadge","activatedIdentifierFull","portalHost","accreditationBadges","protectedShields","quantitativeSpecs","readinessScore"],"properties":{"partnerId":{"type":"string"},"displayName":{"type":"string"},"displayNameVi":{"type":"string"},"displayNameEn":{"type":"string"},"legalEntityName":{"type":"string"},"domainKey":{"type":"string","enum":["epigenetics","botanical_isomeric","heavy_metals_pharmacopeia","precision_oncology","turnkey_cgmp"]},"domainLabel":{"type":"string"},"countryCode":{"type":"string"},"locationLabel":{"type":"string"},"headquarters":{"type":"string"},"officialWebsite":{"type":"string","format":"uri"},"establishedNote":{"type":"string"},"relationshipRoleBadge":{"type":"string"},"activatedIdentifierBadge":{"type":"string"},"activatedIdentifierFull":{"type":"string"},"portalHost":{"type":"string"},"accreditationBadges":{"type":"array","items":{"type":"string"}},"protectedShields":{"type":"array","items":{"type":"string"}},"quantitativeSpecs":{"type":"array","items":{"type":"string"}},"clinicalSummary":{"type":"string"},"chainOfCustodyStep":{"type":"string"},"readinessScore":{"type":"integer"}}},"VerifiedPartnersApiResponse":{"type":"object","required":["status","version","corporateIdentity","governanceGateSummary","total","data"],"properties":{"status":{"type":"string","example":"success"},"version":{"type":"string","example":"4.9"},"license":{"type":"string","example":"CC-BY-4.0"},"specification":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"corporateIdentity":{"type":"object"},"governanceGateSummary":{"type":"object","required":["policyRuleId","totalAuditedGlobalCandidates","stage3SignedOfficialCount","stage2InNegotiationCount","stage1ProspectOutreachCount","stage1And2PublicNameDisclosure"],"properties":{"policyRuleId":{"type":"string","example":"MED3-125"},"totalAuditedGlobalCandidates":{"type":"integer"},"stage3SignedOfficialCount":{"type":"integer"},"stage2InNegotiationCount":{"type":"integer"},"stage1ProspectOutreachCount":{"type":"integer"},"sealedCandidatesCount":{"type":"integer"},"stage1And2PublicNameDisclosure":{"type":"string","example":"STRICTLY_REDACTED_ZERO_LEAK"}}},"total":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/VerifiedPartnerDossier"}},"error":{"oneOf":[{"type":"string"},{"type":"null"}],"example":null},"meta":{"type":"object"}}},"AgentDiscoveryManifest":{"type":"object","required":["schemaVersion","name","version","url","provider","capabilities","skills"],"properties":{"schemaVersion":{"type":"string","example":"1.0"},"name":{"type":"string"},"description":{"type":"string"},"version":{"type":"string","example":"5.2"},"url":{"type":"string","format":"uri"},"provider":{"type":"object"},"documentationUrl":{"type":"string","format":"uri"},"llmsTxtUrl":{"type":"string","format":"uri"},"openApiUrl":{"type":"string","format":"uri"},"humanVerificationUrl":{"type":"string","format":"uri"},"governancePolicy":{"type":"object"},"capabilities":{"type":"object","properties":{"streaming":{"type":"boolean"},"pushNotifications":{"type":"boolean"},"stateTransitionHistory":{"type":"boolean"}}},"skills":{"type":"array","items":{"type":"object"}},"endpoints":{"type":"array","items":{"type":"object"}},"authentication":{"type":"object"},"specialistCouncilSummary":{"type":"array","items":{"type":"object"}}}},"ApiErrorResponse":{"type":"object","required":["status","error","message","data"],"properties":{"status":{"type":"string","example":"error"},"error":{"type":"string"},"message":{"type":"string"},"data":{"type":"null"},"meta":{"type":"object","properties":{"version":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}}}},"Zone2CalibrationApiResponse":{"type":"object","required":["status","version","data","error","meta"],"properties":{"status":{"type":"string","example":"success"},"version":{"type":"string","example":"5.2"},"data":{"type":"object"},"error":{"oneOf":[{"type":"string"},{"type":"null"}],"example":null},"meta":{"type":"object"}}},"TriageApiResponse":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"caseId":{"type":"string"},"subject_ref":{"type":"string"},"handoverState":{"type":"string"},"commercialHandoverUnlocked":{"type":"boolean"}}}}}}