2026-03-16 07:24:50 +07:00
|
|
|
/api/test:
|
|
|
|
|
get:
|
2026-03-16 15:58:56 +07:00
|
|
|
tags: [Test]
|
2026-03-16 07:24:50 +07:00
|
|
|
summary: List test definitions
|
|
|
|
|
security:
|
|
|
|
|
- bearerAuth: []
|
|
|
|
|
parameters:
|
|
|
|
|
- name: page
|
|
|
|
|
in: query
|
|
|
|
|
schema:
|
|
|
|
|
type: integer
|
|
|
|
|
default: 1
|
|
|
|
|
description: Page number for pagination
|
|
|
|
|
- name: perPage
|
|
|
|
|
in: query
|
|
|
|
|
schema:
|
|
|
|
|
type: integer
|
|
|
|
|
default: 20
|
|
|
|
|
description: Number of items per page
|
|
|
|
|
- name: SiteID
|
|
|
|
|
in: query
|
|
|
|
|
schema:
|
|
|
|
|
type: integer
|
|
|
|
|
description: Filter by site ID
|
|
|
|
|
- name: TestType
|
|
|
|
|
in: query
|
|
|
|
|
schema:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [TEST, PARAM, CALC, GROUP, TITLE]
|
|
|
|
|
description: Filter by test type
|
|
|
|
|
- name: VisibleScr
|
|
|
|
|
in: query
|
|
|
|
|
schema:
|
|
|
|
|
type: integer
|
|
|
|
|
enum: [0, 1]
|
|
|
|
|
description: Filter by screen visibility (0=hidden, 1=visible)
|
|
|
|
|
- name: VisibleRpt
|
|
|
|
|
in: query
|
|
|
|
|
schema:
|
|
|
|
|
type: integer
|
|
|
|
|
enum: [0, 1]
|
|
|
|
|
description: Filter by report visibility (0=hidden, 1=visible)
|
|
|
|
|
- name: search
|
|
|
|
|
in: query
|
|
|
|
|
schema:
|
|
|
|
|
type: string
|
|
|
|
|
description: Search by test code or name
|
|
|
|
|
responses:
|
|
|
|
|
'200':
|
|
|
|
|
description: List of test definitions
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
status:
|
|
|
|
|
type: string
|
|
|
|
|
data:
|
|
|
|
|
type: array
|
|
|
|
|
items:
|
|
|
|
|
$ref: '../components/schemas/tests.yaml#/TestDefinition'
|
|
|
|
|
pagination:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
total:
|
|
|
|
|
type: integer
|
|
|
|
|
description: Total number of records matching the query
|
|
|
|
|
|
|
|
|
|
post:
|
2026-03-16 15:58:56 +07:00
|
|
|
tags: [Test]
|
2026-03-16 07:24:50 +07:00
|
|
|
summary: Create test definition
|
|
|
|
|
security:
|
|
|
|
|
- bearerAuth: []
|
|
|
|
|
requestBody:
|
|
|
|
|
required: true
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
SiteID:
|
|
|
|
|
type: integer
|
|
|
|
|
description: Site ID (required)
|
|
|
|
|
TestSiteCode:
|
|
|
|
|
type: string
|
|
|
|
|
description: Test code (required)
|
|
|
|
|
TestSiteName:
|
|
|
|
|
type: string
|
|
|
|
|
description: Test name (required)
|
|
|
|
|
TestType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [TEST, PARAM, CALC, GROUP, TITLE]
|
|
|
|
|
description: Test type (required)
|
|
|
|
|
Description:
|
|
|
|
|
type: string
|
|
|
|
|
DisciplineID:
|
|
|
|
|
type: integer
|
|
|
|
|
DepartmentID:
|
|
|
|
|
type: integer
|
|
|
|
|
ResultType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [NMRIC, RANGE, TEXT, VSET, NORES]
|
|
|
|
|
RefType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [RANGE, THOLD, VSET, TEXT, NOREF]
|
|
|
|
|
VSet:
|
|
|
|
|
type: integer
|
|
|
|
|
ReqQty:
|
|
|
|
|
type: number
|
|
|
|
|
format: decimal
|
|
|
|
|
ReqQtyUnit:
|
|
|
|
|
type: string
|
|
|
|
|
Unit1:
|
|
|
|
|
type: string
|
|
|
|
|
Factor:
|
|
|
|
|
type: number
|
|
|
|
|
format: decimal
|
|
|
|
|
Unit2:
|
|
|
|
|
type: string
|
|
|
|
|
Decimal:
|
|
|
|
|
type: integer
|
|
|
|
|
CollReq:
|
|
|
|
|
type: string
|
|
|
|
|
Method:
|
|
|
|
|
type: string
|
|
|
|
|
ExpectedTAT:
|
|
|
|
|
type: integer
|
|
|
|
|
SeqScr:
|
|
|
|
|
type: integer
|
|
|
|
|
SeqRpt:
|
|
|
|
|
type: integer
|
|
|
|
|
IndentLeft:
|
|
|
|
|
type: integer
|
|
|
|
|
FontStyle:
|
|
|
|
|
type: string
|
|
|
|
|
VisibleScr:
|
|
|
|
|
type: integer
|
|
|
|
|
VisibleRpt:
|
|
|
|
|
type: integer
|
|
|
|
|
CountStat:
|
|
|
|
|
type: integer
|
|
|
|
|
details:
|
|
|
|
|
type: object
|
|
|
|
|
description: |
|
|
|
|
|
Type-specific details. For CALC and GROUP types, include members array.
|
|
|
|
|
|
|
|
|
|
**Important**: Members must use `TestSiteID` (the actual test ID), NOT `Member` or `SeqScr`.
|
|
|
|
|
Invalid TestSiteIDs will result in a 400 error.
|
|
|
|
|
properties:
|
|
|
|
|
DisciplineID:
|
|
|
|
|
type: integer
|
|
|
|
|
DepartmentID:
|
|
|
|
|
type: integer
|
|
|
|
|
ResultType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [NMRIC, RANGE, TEXT, VSET, NORES]
|
|
|
|
|
RefType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [RANGE, THOLD, VSET, TEXT, NOREF]
|
|
|
|
|
FormulaCode:
|
|
|
|
|
type: string
|
|
|
|
|
description: Formula expression for CALC type (e.g., "{TBIL} - {DBIL}")
|
|
|
|
|
Unit1:
|
|
|
|
|
type: string
|
|
|
|
|
Factor:
|
|
|
|
|
type: number
|
|
|
|
|
Unit2:
|
|
|
|
|
type: string
|
|
|
|
|
Decimal:
|
|
|
|
|
type: integer
|
|
|
|
|
default: 2
|
|
|
|
|
Method:
|
|
|
|
|
type: string
|
|
|
|
|
ExpectedTAT:
|
|
|
|
|
type: integer
|
|
|
|
|
members:
|
|
|
|
|
type: array
|
|
|
|
|
description: |
|
|
|
|
|
Array of member tests for CALC and GROUP types.
|
|
|
|
|
Each member object must contain `TestSiteID` (the actual test ID).
|
|
|
|
|
Do NOT use `Member` or `SeqScr` - these will be rejected with validation error.
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
TestSiteID:
|
|
|
|
|
type: integer
|
|
|
|
|
description: The actual TestSiteID of the member test (required)
|
|
|
|
|
required:
|
|
|
|
|
- TestSiteID
|
|
|
|
|
refnum:
|
|
|
|
|
type: array
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
reftxt:
|
|
|
|
|
type: array
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
testmap:
|
|
|
|
|
type: array
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
required:
|
|
|
|
|
- SiteID
|
|
|
|
|
- TestSiteCode
|
|
|
|
|
- TestSiteName
|
|
|
|
|
- TestType
|
|
|
|
|
examples:
|
2026-03-16 15:58:56 +07:00
|
|
|
TEST_no_ref:
|
|
|
|
|
summary: Technical test without reference or map
|
2026-03-16 07:24:50 +07:00
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
2026-03-16 15:58:56 +07:00
|
|
|
TestSiteCode: TEST_NREF
|
|
|
|
|
TestSiteName: Numeric Test
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 500
|
|
|
|
|
SeqRpt: 500
|
2026-03-16 07:24:50 +07:00
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
2026-03-16 15:58:56 +07:00
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 2
|
|
|
|
|
DepartmentID: 2
|
|
|
|
|
Unit1: mg/dL
|
|
|
|
|
Method: CBC Analyzer
|
|
|
|
|
PARAM_no_ref:
|
|
|
|
|
summary: Parameter without reference or map
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: PARAM_NRF
|
|
|
|
|
TestSiteName: Clinical Parameter
|
|
|
|
|
TestType: PARAM
|
|
|
|
|
SeqScr: 10
|
|
|
|
|
SeqRpt: 10
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 0
|
2026-03-16 07:24:50 +07:00
|
|
|
CountStat: 0
|
2026-03-16 15:58:56 +07:00
|
|
|
details:
|
|
|
|
|
DisciplineID: 10
|
|
|
|
|
DepartmentID: 0
|
|
|
|
|
Unit1: cm
|
|
|
|
|
Method: Manual entry
|
|
|
|
|
TEST_range_single:
|
|
|
|
|
summary: Technical test with numeric range reference (single)
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_RANGE
|
|
|
|
|
TestSiteName: Glucose Range
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 105
|
|
|
|
|
SeqRpt: 105
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 2
|
|
|
|
|
DepartmentID: 2
|
|
|
|
|
ResultType: NMRIC
|
|
|
|
|
RefType: RANGE
|
|
|
|
|
Unit1: mg/dL
|
|
|
|
|
Method: Hexokinase
|
|
|
|
|
refnum:
|
|
|
|
|
- NumRefType: NMRC
|
|
|
|
|
RangeType: REF
|
|
|
|
|
Sex: '2'
|
|
|
|
|
LowSign: GE
|
|
|
|
|
Low: 70
|
|
|
|
|
HighSign: LE
|
|
|
|
|
High: 100
|
|
|
|
|
AgeStart: 18
|
|
|
|
|
AgeEnd: 99
|
|
|
|
|
Flag: N
|
|
|
|
|
TEST_range_multiple_map:
|
|
|
|
|
summary: Numeric reference with multiple ranges and test map
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_RMAP
|
|
|
|
|
TestSiteName: Glucose Panic Range
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 110
|
|
|
|
|
SeqRpt: 110
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
2026-03-16 07:24:50 +07:00
|
|
|
details:
|
|
|
|
|
DisciplineID: 2
|
|
|
|
|
DepartmentID: 2
|
2026-03-16 15:58:56 +07:00
|
|
|
ResultType: NMRIC
|
2026-03-16 07:24:50 +07:00
|
|
|
RefType: RANGE
|
|
|
|
|
Unit1: mg/dL
|
2026-03-16 15:58:56 +07:00
|
|
|
Method: Hexokinase
|
|
|
|
|
refnum:
|
|
|
|
|
- NumRefType: NMRC
|
|
|
|
|
RangeType: REF
|
|
|
|
|
Sex: '2'
|
|
|
|
|
LowSign: GE
|
|
|
|
|
Low: 70
|
|
|
|
|
HighSign: LE
|
|
|
|
|
High: 100
|
|
|
|
|
AgeStart: 18
|
|
|
|
|
AgeEnd: 99
|
|
|
|
|
Flag: N
|
|
|
|
|
- NumRefType: NMRC
|
|
|
|
|
RangeType: REF
|
|
|
|
|
Sex: '1'
|
|
|
|
|
LowSign: '>'
|
|
|
|
|
Low: 75
|
|
|
|
|
HighSign: '<'
|
|
|
|
|
High: 105
|
|
|
|
|
AgeStart: 18
|
|
|
|
|
AgeEnd: 99
|
|
|
|
|
Flag: N
|
|
|
|
|
testmap:
|
|
|
|
|
- HostType: SITE
|
|
|
|
|
HostID: '1'
|
|
|
|
|
ClientType: WST
|
|
|
|
|
ClientID: '1'
|
|
|
|
|
details:
|
|
|
|
|
- HostTestCode: GLU
|
|
|
|
|
HostTestName: Glucose
|
|
|
|
|
ConDefID: 1
|
|
|
|
|
ClientTestCode: GLU_C
|
|
|
|
|
ClientTestName: Glucose Client
|
|
|
|
|
- HostTestCode: CREA
|
|
|
|
|
HostTestName: Creatinine
|
|
|
|
|
ConDefID: 2
|
|
|
|
|
ClientTestCode: CREA_C
|
|
|
|
|
ClientTestName: Creatinine Client
|
|
|
|
|
- HostType: WST
|
|
|
|
|
HostID: '3'
|
|
|
|
|
ClientType: INST
|
|
|
|
|
ClientID: '2'
|
|
|
|
|
details:
|
|
|
|
|
- HostTestCode: HB
|
|
|
|
|
HostTestName: Hemoglobin
|
|
|
|
|
ConDefID: 3
|
|
|
|
|
ClientTestCode: HB_C
|
|
|
|
|
ClientTestName: Hemoglobin Client
|
|
|
|
|
TEST_threshold:
|
|
|
|
|
summary: Technical test with threshold reference
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_THLD
|
|
|
|
|
TestSiteName: Sodium Threshold
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 115
|
|
|
|
|
SeqRpt: 115
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 2
|
|
|
|
|
DepartmentID: 2
|
|
|
|
|
ResultType: NMRIC
|
|
|
|
|
RefType: THOLD
|
|
|
|
|
Unit1: mmol/L
|
|
|
|
|
Method: Auto Analyzer
|
|
|
|
|
refnum:
|
|
|
|
|
- NumRefType: THOLD
|
|
|
|
|
RangeType: PANIC
|
|
|
|
|
Sex: '2'
|
|
|
|
|
LowSign: LT
|
|
|
|
|
Low: 120
|
|
|
|
|
AgeStart: 0
|
|
|
|
|
AgeEnd: 125
|
|
|
|
|
Flag: H
|
|
|
|
|
TEST_threshold_map:
|
|
|
|
|
summary: Threshold reference plus test map
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_TMAP
|
|
|
|
|
TestSiteName: Potassium Panic
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 120
|
|
|
|
|
SeqRpt: 120
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 2
|
|
|
|
|
DepartmentID: 2
|
|
|
|
|
ResultType: NMRIC
|
|
|
|
|
RefType: THOLD
|
|
|
|
|
Unit1: mmol/L
|
|
|
|
|
Method: Auto Analyzer
|
|
|
|
|
refnum:
|
|
|
|
|
- NumRefType: THOLD
|
|
|
|
|
RangeType: PANIC
|
|
|
|
|
Sex: '2'
|
|
|
|
|
LowSign: LT
|
|
|
|
|
Low: 120
|
|
|
|
|
AgeStart: 0
|
|
|
|
|
AgeEnd: 125
|
|
|
|
|
Flag: H
|
|
|
|
|
- NumRefType: THOLD
|
|
|
|
|
RangeType: PANIC
|
|
|
|
|
Sex: '1'
|
|
|
|
|
LowSign: '<'
|
|
|
|
|
Low: 121
|
|
|
|
|
AgeStart: 0
|
|
|
|
|
AgeEnd: 125
|
|
|
|
|
Flag: H
|
|
|
|
|
testmap:
|
|
|
|
|
- HostType: SITE
|
|
|
|
|
HostID: '1'
|
|
|
|
|
ClientType: WST
|
|
|
|
|
ClientID: '1'
|
|
|
|
|
details:
|
|
|
|
|
- HostTestCode: HB
|
|
|
|
|
HostTestName: Hemoglobin
|
|
|
|
|
ConDefID: 3
|
|
|
|
|
ClientTestCode: HB_C
|
|
|
|
|
ClientTestName: Hemoglobin Client
|
|
|
|
|
- HostTestCode: GLU
|
|
|
|
|
HostTestName: Glucose
|
|
|
|
|
ConDefID: 1
|
|
|
|
|
ClientTestCode: GLU_C
|
|
|
|
|
ClientTestName: Glucose Client
|
|
|
|
|
TEST_text:
|
|
|
|
|
summary: Technical test with text reference
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_TEXT
|
|
|
|
|
TestSiteName: Disease Stage
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 130
|
|
|
|
|
SeqRpt: 130
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 1
|
|
|
|
|
DepartmentID: 1
|
|
|
|
|
ResultType: TEXT
|
|
|
|
|
RefType: TEXT
|
|
|
|
|
Method: Morphology
|
|
|
|
|
reftxt:
|
|
|
|
|
- SpcType: GEN
|
|
|
|
|
TxtRefType: TEXT
|
|
|
|
|
Sex: '2'
|
|
|
|
|
AgeStart: 18
|
|
|
|
|
AgeEnd: 99
|
|
|
|
|
RefTxt: 'NORM=Normal;HIGH=High'
|
|
|
|
|
Flag: N
|
|
|
|
|
TEST_text_map:
|
|
|
|
|
summary: Text reference plus test map
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_TXM
|
|
|
|
|
TestSiteName: Disease Stage (Map)
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 135
|
|
|
|
|
SeqRpt: 135
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 1
|
|
|
|
|
DepartmentID: 1
|
|
|
|
|
ResultType: TEXT
|
|
|
|
|
RefType: TEXT
|
|
|
|
|
reftxt:
|
|
|
|
|
- SpcType: GEN
|
|
|
|
|
TxtRefType: TEXT
|
|
|
|
|
Sex: '2'
|
|
|
|
|
AgeStart: 18
|
|
|
|
|
AgeEnd: 99
|
|
|
|
|
RefTxt: 'NORM=Normal'
|
|
|
|
|
Flag: N
|
|
|
|
|
- SpcType: GEN
|
|
|
|
|
TxtRefType: TEXT
|
|
|
|
|
Sex: '1'
|
|
|
|
|
AgeStart: 18
|
|
|
|
|
AgeEnd: 99
|
|
|
|
|
RefTxt: 'ABN=Abnormal'
|
|
|
|
|
Flag: N
|
|
|
|
|
testmap:
|
|
|
|
|
- HostType: SITE
|
|
|
|
|
HostID: '1'
|
|
|
|
|
ClientType: WST
|
|
|
|
|
ClientID: '1'
|
|
|
|
|
details:
|
|
|
|
|
- HostTestCode: STAGE
|
|
|
|
|
HostTestName: Disease Stage
|
|
|
|
|
ConDefID: 4
|
|
|
|
|
ClientTestCode: STAGE_C
|
|
|
|
|
ClientTestName: Disease Stage Client
|
|
|
|
|
TEST_valueset:
|
|
|
|
|
summary: Technical test using a value set result
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_VSET
|
|
|
|
|
TestSiteName: Urine Color
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 140
|
|
|
|
|
SeqRpt: 140
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 4
|
|
|
|
|
DepartmentID: 4
|
|
|
|
|
ResultType: VSET
|
|
|
|
|
RefType: VSET
|
|
|
|
|
Method: Visual
|
|
|
|
|
reftxt:
|
|
|
|
|
- SpcType: GEN
|
|
|
|
|
TxtRefType: VSET
|
|
|
|
|
Sex: '2'
|
|
|
|
|
AgeStart: 0
|
|
|
|
|
AgeEnd: 120
|
|
|
|
|
RefTxt: 'NORM=Normal;MACRO=Macro'
|
|
|
|
|
Flag: N
|
|
|
|
|
TEST_valueset_map:
|
|
|
|
|
summary: Value set reference with test map
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_VMAP
|
|
|
|
|
TestSiteName: Urine Color (Map)
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 145
|
|
|
|
|
SeqRpt: 145
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 4
|
|
|
|
|
DepartmentID: 4
|
|
|
|
|
ResultType: VSET
|
|
|
|
|
RefType: VSET
|
|
|
|
|
reftxt:
|
|
|
|
|
- SpcType: GEN
|
|
|
|
|
TxtRefType: VSET
|
|
|
|
|
Sex: '2'
|
|
|
|
|
AgeStart: 0
|
|
|
|
|
AgeEnd: 120
|
|
|
|
|
RefTxt: 'NORM=Normal;ABN=Abnormal'
|
|
|
|
|
Flag: N
|
|
|
|
|
testmap:
|
|
|
|
|
- HostType: SITE
|
|
|
|
|
HostID: '1'
|
|
|
|
|
ClientType: WST
|
|
|
|
|
ClientID: '8'
|
|
|
|
|
details:
|
|
|
|
|
- HostTestCode: UCOLOR
|
|
|
|
|
HostTestName: Urine Color
|
|
|
|
|
ConDefID: 12
|
|
|
|
|
ClientTestCode: UCOLOR_C
|
|
|
|
|
ClientTestName: Urine Color Client
|
|
|
|
|
TEST_valueset_map_no_reftxt:
|
|
|
|
|
summary: Value set result with mapping but without explicit text reference entries
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: TEST_VSETM
|
|
|
|
|
TestSiteName: Urine Result Map
|
|
|
|
|
TestType: TEST
|
|
|
|
|
SeqScr: 150
|
|
|
|
|
SeqRpt: 150
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 4
|
|
|
|
|
DepartmentID: 4
|
|
|
|
|
ResultType: VSET
|
|
|
|
|
RefType: VSET
|
|
|
|
|
testmap:
|
|
|
|
|
- HostType: SITE
|
|
|
|
|
HostID: '1'
|
|
|
|
|
ClientType: WST
|
|
|
|
|
ClientID: '8'
|
|
|
|
|
details:
|
|
|
|
|
- HostTestCode: UGLUC
|
|
|
|
|
HostTestName: Urine Glucose
|
|
|
|
|
ConDefID: 12
|
|
|
|
|
ClientTestCode: UGLUC_C
|
|
|
|
|
ClientTestName: Urine Glucose Client
|
|
|
|
|
CALC_basic:
|
|
|
|
|
summary: Calculated test with members (no references)
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: CALC_BASE
|
|
|
|
|
TestSiteName: Estimated GFR
|
|
|
|
|
TestType: CALC
|
|
|
|
|
SeqScr: 190
|
|
|
|
|
SeqRpt: 190
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 0
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 2
|
|
|
|
|
DepartmentID: 2
|
|
|
|
|
FormulaCode: CKD_EPI(CREA,AGE,GENDER)
|
2026-03-16 07:24:50 +07:00
|
|
|
members:
|
2026-03-16 15:58:56 +07:00
|
|
|
- TestSiteID: 21
|
2026-03-16 07:24:50 +07:00
|
|
|
- TestSiteID: 22
|
2026-03-16 15:58:56 +07:00
|
|
|
CALC_full:
|
|
|
|
|
summary: Calculated test with numeric reference ranges and map
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: CALC_FULL
|
|
|
|
|
TestSiteName: Estimated GFR (Map)
|
|
|
|
|
TestType: CALC
|
|
|
|
|
SeqScr: 195
|
|
|
|
|
SeqRpt: 195
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 0
|
|
|
|
|
details:
|
|
|
|
|
DisciplineID: 2
|
|
|
|
|
DepartmentID: 2
|
|
|
|
|
FormulaCode: CKD_EPI(CREA,AGE,GENDER)
|
|
|
|
|
members:
|
|
|
|
|
- TestSiteID: 21
|
|
|
|
|
- TestSiteID: 22
|
|
|
|
|
refnum:
|
|
|
|
|
- NumRefType: NMRC
|
|
|
|
|
RangeType: REF
|
|
|
|
|
Sex: '2'
|
|
|
|
|
LowSign: GE
|
|
|
|
|
Low: 10
|
|
|
|
|
HighSign: LE
|
|
|
|
|
High: 20
|
|
|
|
|
AgeStart: 18
|
|
|
|
|
AgeEnd: 120
|
|
|
|
|
Flag: N
|
|
|
|
|
testmap:
|
|
|
|
|
- HostType: SITE
|
|
|
|
|
HostID: '1'
|
|
|
|
|
ClientType: WST
|
|
|
|
|
ClientID: '3'
|
|
|
|
|
details:
|
|
|
|
|
- HostTestCode: EGFR
|
|
|
|
|
HostTestName: eGFR
|
|
|
|
|
ConDefID: 1
|
|
|
|
|
ClientTestCode: EGFR_C
|
|
|
|
|
ClientTestName: eGFR Client
|
|
|
|
|
GROUP_with_members:
|
|
|
|
|
summary: Group/profile test with members and mapping
|
|
|
|
|
value:
|
|
|
|
|
SiteID: 1
|
|
|
|
|
TestSiteCode: GROUP_PNL
|
|
|
|
|
TestSiteName: Lipid Profile
|
|
|
|
|
TestType: GROUP
|
|
|
|
|
SeqScr: 10
|
|
|
|
|
SeqRpt: 10
|
|
|
|
|
VisibleScr: 1
|
|
|
|
|
VisibleRpt: 1
|
|
|
|
|
CountStat: 1
|
|
|
|
|
details:
|
|
|
|
|
members:
|
|
|
|
|
- TestSiteID: 169
|
|
|
|
|
- TestSiteID: 170
|
|
|
|
|
testmap:
|
|
|
|
|
- HostType: SITE
|
|
|
|
|
HostID: '1'
|
|
|
|
|
ClientType: WST
|
|
|
|
|
ClientID: '3'
|
|
|
|
|
details:
|
|
|
|
|
- HostTestCode: LIPID
|
|
|
|
|
HostTestName: Lipid Profile
|
|
|
|
|
ConDefID: 1
|
|
|
|
|
ClientTestCode: LIPID_C
|
|
|
|
|
ClientTestName: Lipid Client
|
2026-03-16 07:24:50 +07:00
|
|
|
responses:
|
|
|
|
|
'201':
|
|
|
|
|
description: Test definition created
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
status:
|
|
|
|
|
type: string
|
|
|
|
|
example: created
|
|
|
|
|
message:
|
|
|
|
|
type: string
|
|
|
|
|
data:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
TestSiteId:
|
|
|
|
|
type: integer
|
|
|
|
|
'400':
|
|
|
|
|
description: Validation error (e.g., invalid member TestSiteID)
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
status:
|
|
|
|
|
type: string
|
|
|
|
|
example: failed
|
|
|
|
|
message:
|
|
|
|
|
type: string
|
|
|
|
|
example: 'Invalid member TestSiteID(s): 185, 186. Make sure to use TestSiteID, not SeqScr or other values.'
|
|
|
|
|
|
|
|
|
|
patch:
|
2026-03-16 15:58:56 +07:00
|
|
|
tags: [Test]
|
2026-03-16 07:24:50 +07:00
|
|
|
summary: Update test definition
|
|
|
|
|
security:
|
|
|
|
|
- bearerAuth: []
|
|
|
|
|
requestBody:
|
|
|
|
|
required: true
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
TestSiteID:
|
|
|
|
|
type: integer
|
|
|
|
|
description: Test Site ID (required)
|
|
|
|
|
TestSiteCode:
|
|
|
|
|
type: string
|
|
|
|
|
TestSiteName:
|
|
|
|
|
type: string
|
|
|
|
|
TestType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [TEST, PARAM, CALC, GROUP, TITLE]
|
|
|
|
|
Description:
|
|
|
|
|
type: string
|
|
|
|
|
DisciplineID:
|
|
|
|
|
type: integer
|
|
|
|
|
DepartmentID:
|
|
|
|
|
type: integer
|
|
|
|
|
ResultType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [NMRIC, RANGE, TEXT, VSET, NORES]
|
|
|
|
|
RefType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [RANGE, THOLD, VSET, TEXT, NOREF]
|
|
|
|
|
VSet:
|
|
|
|
|
type: integer
|
|
|
|
|
ReqQty:
|
|
|
|
|
type: number
|
|
|
|
|
format: decimal
|
|
|
|
|
ReqQtyUnit:
|
|
|
|
|
type: string
|
|
|
|
|
Unit1:
|
|
|
|
|
type: string
|
|
|
|
|
Factor:
|
|
|
|
|
type: number
|
|
|
|
|
format: decimal
|
|
|
|
|
Unit2:
|
|
|
|
|
type: string
|
|
|
|
|
Decimal:
|
|
|
|
|
type: integer
|
|
|
|
|
CollReq:
|
|
|
|
|
type: string
|
|
|
|
|
Method:
|
|
|
|
|
type: string
|
|
|
|
|
ExpectedTAT:
|
|
|
|
|
type: integer
|
|
|
|
|
SeqScr:
|
|
|
|
|
type: integer
|
|
|
|
|
SeqRpt:
|
|
|
|
|
type: integer
|
|
|
|
|
IndentLeft:
|
|
|
|
|
type: integer
|
|
|
|
|
FontStyle:
|
|
|
|
|
type: string
|
|
|
|
|
VisibleScr:
|
|
|
|
|
type: integer
|
|
|
|
|
VisibleRpt:
|
|
|
|
|
type: integer
|
|
|
|
|
CountStat:
|
|
|
|
|
type: integer
|
|
|
|
|
details:
|
|
|
|
|
type: object
|
|
|
|
|
description: |
|
|
|
|
|
Type-specific details. For CALC and GROUP types, include members array.
|
|
|
|
|
|
|
|
|
|
**Important**: Members must use `TestSiteID` (the actual test ID), NOT `Member` or `SeqScr`.
|
|
|
|
|
Invalid TestSiteIDs will result in a 400 error.
|
|
|
|
|
properties:
|
|
|
|
|
DisciplineID:
|
|
|
|
|
type: integer
|
|
|
|
|
DepartmentID:
|
|
|
|
|
type: integer
|
|
|
|
|
ResultType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [NMRIC, RANGE, TEXT, VSET, NORES]
|
|
|
|
|
RefType:
|
|
|
|
|
type: string
|
|
|
|
|
enum: [RANGE, THOLD, VSET, TEXT, NOREF]
|
|
|
|
|
FormulaCode:
|
|
|
|
|
type: string
|
|
|
|
|
description: Formula expression for CALC type (e.g., "{TBIL} - {DBIL}")
|
|
|
|
|
Unit1:
|
|
|
|
|
type: string
|
|
|
|
|
Factor:
|
|
|
|
|
type: number
|
|
|
|
|
Unit2:
|
|
|
|
|
type: string
|
|
|
|
|
Decimal:
|
|
|
|
|
type: integer
|
|
|
|
|
default: 2
|
|
|
|
|
Method:
|
|
|
|
|
type: string
|
|
|
|
|
ExpectedTAT:
|
|
|
|
|
type: integer
|
|
|
|
|
members:
|
|
|
|
|
type: array
|
|
|
|
|
description: |
|
|
|
|
|
Array of member tests for CALC and GROUP types.
|
|
|
|
|
Each member object must contain `TestSiteID` (the actual test ID).
|
|
|
|
|
Do NOT use `Member` or `SeqScr` - these will be rejected with validation error.
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
TestSiteID:
|
|
|
|
|
type: integer
|
|
|
|
|
description: The actual TestSiteID of the member test (required)
|
|
|
|
|
required:
|
|
|
|
|
- TestSiteID
|
|
|
|
|
refnum:
|
|
|
|
|
type: array
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
reftxt:
|
|
|
|
|
type: array
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
testmap:
|
|
|
|
|
type: array
|
|
|
|
|
items:
|
|
|
|
|
type: object
|
|
|
|
|
required:
|
|
|
|
|
- TestSiteID
|
|
|
|
|
responses:
|
|
|
|
|
'200':
|
|
|
|
|
description: Test definition updated
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
status:
|
|
|
|
|
type: string
|
|
|
|
|
example: success
|
|
|
|
|
message:
|
|
|
|
|
type: string
|
|
|
|
|
data:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
TestSiteId:
|
|
|
|
|
type: integer
|
|
|
|
|
'400':
|
|
|
|
|
description: Validation error (e.g., invalid member TestSiteID)
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
status:
|
|
|
|
|
type: string
|
|
|
|
|
example: failed
|
|
|
|
|
message:
|
|
|
|
|
type: string
|
|
|
|
|
example: 'Invalid member TestSiteID(s): 185, 186. Make sure to use TestSiteID, not SeqScr or other values.'
|
|
|
|
|
|
|
|
|
|
/api/test/{id}:
|
|
|
|
|
get:
|
2026-03-16 15:58:56 +07:00
|
|
|
tags: [Test]
|
2026-03-16 07:24:50 +07:00
|
|
|
summary: Get test definition by ID
|
|
|
|
|
security:
|
|
|
|
|
- bearerAuth: []
|
|
|
|
|
parameters:
|
|
|
|
|
- name: id
|
|
|
|
|
in: path
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
type: integer
|
|
|
|
|
description: Test Site ID
|
|
|
|
|
responses:
|
|
|
|
|
'200':
|
|
|
|
|
description: Test definition details
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
status:
|
|
|
|
|
type: string
|
|
|
|
|
message:
|
|
|
|
|
type: string
|
|
|
|
|
data:
|
|
|
|
|
$ref: '../components/schemas/tests.yaml#/TestDefinition'
|
|
|
|
|
'404':
|
|
|
|
|
description: Test not found
|
|
|
|
|
|
|
|
|
|
delete:
|
2026-03-16 15:58:56 +07:00
|
|
|
tags: [Test]
|
2026-03-16 07:24:50 +07:00
|
|
|
summary: Soft delete test definition
|
|
|
|
|
security:
|
|
|
|
|
- bearerAuth: []
|
|
|
|
|
parameters:
|
|
|
|
|
- name: id
|
|
|
|
|
in: path
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
type: integer
|
|
|
|
|
description: Test Site ID to delete
|
|
|
|
|
requestBody:
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
TestSiteID:
|
|
|
|
|
type: integer
|
|
|
|
|
description: Optional - can be provided in body instead of path
|
|
|
|
|
responses:
|
|
|
|
|
'200':
|
|
|
|
|
description: Test disabled successfully
|
|
|
|
|
content:
|
|
|
|
|
application/json:
|
|
|
|
|
schema:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
status:
|
|
|
|
|
type: string
|
|
|
|
|
example: success
|
|
|
|
|
message:
|
|
|
|
|
type: string
|
|
|
|
|
data:
|
|
|
|
|
type: object
|
|
|
|
|
properties:
|
|
|
|
|
TestSiteId:
|
|
|
|
|
type: integer
|
|
|
|
|
EndDate:
|
|
|
|
|
type: string
|
|
|
|
|
format: date-time
|
|
|
|
|
'404':
|
|
|
|
|
description: Test not found
|
|
|
|
|
'422':
|
|
|
|
|
description: Test already disabled
|
