DR

2 获取软件信息

GET /dr/api/v1/pub/software_info

接口说明

公开接口

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "data": {
    "FPD": "Simulator",
    "GEN": "Simulator",
    "guest": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTY3MjAxMTUsImlkIjoyLCJuYW1lIjoiZ3Vlc3QifQ.cDkkxM2mkiCQf7T87WsCMewITk13c7jSDoniT7gDHXQ",
    "language": ["en", "zh"],
    "product": "DROS",
    "server": {
      "auth": {
        "build": "2025-08-25 17:45:18",
        "desc": "Authentication Server repo",
        "submodule": ["3a167dd4[rpc_idl]"],
        "version": "0.3.0-13-g8b85622"
      },
      "dcmtk": {
        "build": "2025-08-25 13:43:16",
        "desc": "Dcmtk Server repo",
        "submodule": ["0fc2b1e4[rpc_idl]"],
        "version": "0.3.0-12-gff618d4"
      },
      "imgProc": {
        "build": "2025-08-25 13:46:23",
        "desc": "Img Proc Server repo",
        "submodule": [
          "5e507af7[auto_wwwl]",
          "3a75bb1f[collimator_circle]",
          "e7b69785[collimator_rect]",
          "6b7fbbd1[enhance]",
          "5905e001[rpc_idl]"
        ],
        "version": "0.3.0-7-gbb2ee0b"
      },
      "protocol": {
        "build": "2025-08-25 17:45:23",
        "desc": "Protocol Server repo",
        "submodule": ["3a167dd4[rpc_idl]"],
        "version": "0.3.0-7-g1954756"
      },
      "resource": {
        "build": "2025-08-25 17:45:27",
        "desc": "Resource Server repo",
        "submodule": ["0fc2b1e4[rpc_idl]"],
        "version": "0.3.0-12-g60e37c1"
      },
      "study": {
        "build": "2025-08-25 17:45:25",
        "desc": "Study Server repo",
        "submodule": ["3a167dd4[rpc_idl]"],
        "version": "0.3.0-11-g784ba1b"
      },
      "task": {
        "build": "2025-08-25 17:45:29",
        "desc": "Task Server repo",
        "submodule": ["0fc2b1e4[rpc_idl]"],
        "version": "0.3.0-20-ge9ec04a"
      }
    },
    "sn": "2edbc382-044adc78-95bed11b-51c9328a"
  },
  "description": "Success",
  "solution": ""
}

3 获取用户列表

GET /dr/api/v1/pub/users

接口说明

公开接口

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "data": ["service", "admin", "mgr", "tech"],
  "description": "Success",
  "solution": ""
}

4 获取示意图

GET /dr/api/v1/pub/Image/xxx/xxx/xxx

接口说明

公开接口

响应体

● 200: OK 响应数据格式：File

图片数据

5 登陆

POST /dr/api/v1/pub/login

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTAwNTU5MzYsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.LLveItQ_K0vvcmyN4qLQHxaOcz3EzY7ZeUQ97hR9R9w
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
username	string	admin	true
password	string	123456	true

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc1ODgsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.0qIzacOIf0-YluwAlrkaNJ9lf9w8IKneWEXh_mjUoN4",
    "expire": 1751277588,
    "uid": 1,
    "name": "admin",
    "avatar": ""
  }
}

6 修改密码

POST /api/v1/auth/settings/password

接口说明

修改当前用户自己的密码

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	不为空	描述
old_password	object	true	旧密码
new_password	string	true	新密码
confirm_new_password	string	true	确认密码

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {}
}

7 获取选项

GET /dr/api/v1/auth/resource/options

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
group	basic	可选项

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.resource.OptionReply",
    "option": [
      {
        "text": "Male",
        "value": "M"
      },
      {
        "text": "Female",
        "value": "F"
      },
      {
        "text": "Other",
        "value": "O"
      },
      {
        "text": "CM",
        "value": "CM"
      },
      {
        "text": "SF",
        "value": "SF"
      }
    ]
  }
}

8 获取配置项

GET /dr/api/v1/auth/resource/config

接口说明

获取全局配置项

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
uri

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.resource.OptionReply",
    "option": [
      {
        "text": "Male",
        "value": "M"
      },
      {
        "text": "Female",
        "value": "F"
      },
      {
        "text": "Other",
        "value": "O"
      },
      {
        "text": "CM",
        "value": "CM"
      },
      {
        "text": "SF",
        "value": "SF"
      }
    ]
  }
}

uri可用值

System/SimulatorGEN 发生器仿真模式
System/SimulatorFPD 探测器仿真模式

9 协议

9.1 获取患者类型

GET /dr/api/v1/auth/protocol/patient_type

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
is_enabled		true 或 false

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "patient_type_list": [
      {
        "id": "1",
        "patient_type_id": "Human",
        "patient_type_name": "Human",
        "patient_type_local": "Human",
        "patient_type_description": "Human",
        "sort": 1,
        "is_enabled": true,
        "product": "DROC",
        "is_pre_install": true
      },
      {
        "id": "2",
        "patient_type_id": "SpecialType",
        "patient_type_name": "SpecialType",
        "patient_type_local": "SpecialType",
        "patient_type_description": "SpecialType",
        "sort": 2,
        "is_enabled": false,
        "product": "DROC",
        "is_pre_install": true
      }
    ]
  }
}

9.2 获取身体部位

GET /dr/api/v1/auth/protocol/body_part

接口说明

根据患者类型获取支持的身体部位

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
patient_type		从患者类型接口获取
modality		暂时只有DX
is_enabled		true 或 false

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "body_part_list": [
      {
        "id": "1",
        "body_part_id": "Human_SKULL",
        "body_part_name": "颅骨",
        "body_part_local": "颅骨",
        "body_part_description": "Skull",
        "patient_type": "Human",
        "category": "DX",
        "sort": 1,
        "is_enabled": true,
        "product": "DROC",
        "is_pre_install": true
      },
      {
        "id": "2",
        "body_part_id": "Human_NECK",
        "body_part_name": "颈部",
        "body_part_local": "颈部",
        "body_part_description": "Neck",
        "patient_type": "Human",
        "category": "DX",
        "sort": 2,
        "is_enabled": true,
        "product": "DROC",
        "is_pre_install": true
      }
    ]
  }
}

9.3 获取协议列表

GET /dr/api/v1/auth/protocol/procedure

接口说明

根据身体部位获取协议列表

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
patient_type		从患者类型接口获取
body_part		从身体部位接口获取
procedure_type		NORMAL 或 EMERGENCY
is_enabled		true 或 false
page		页码
取值范围：>0
page_size		行数
取值范围：1-10000

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.ProcedureList",
    "count": 179,
    "procedures": [
      {
        "id": "2",
        "procedure_id": "P0-0002",
        "procedure_code": "P0-0002",
        "procedure_name": "颅骨前后位 + 侧位",
        "procedure_name_local": "颅骨前后位 + 侧位",
        "procedure_other_name": "Skull AP + LAT",
        "procedure_description": "颅骨前后位 + 侧位",
        "procedure_description_local": "颅骨前后位 + 侧位",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "procedure_type": "NORMAL",
        "fast_search": false,
        "protocol_laterality": "U",
        "procedure_category": "Adult",
        "modality": "DX",
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      },
      {
        "id": "3",
        "procedure_id": "P0-0003",
        "procedure_code": "P0-0003",
        "procedure_name": "颅骨后前位 + 侧位",
        "procedure_name_local": "颅骨后前位 + 侧位",
        "procedure_other_name": "Skull PA + LAT",
        "procedure_description": "颅骨后前位 + 侧位",
        "procedure_description_local": "颅骨后前位 + 侧位",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "procedure_type": "NORMAL",
        "fast_search": false,
        "protocol_laterality": "U",
        "procedure_category": "Adult",
        "modality": "DX",
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      },
      {
        "id": "4",
        "procedure_id": "P0-0004",
        "procedure_code": "P0-0004",
        "procedure_name": "颅骨前后位",
        "procedure_name_local": "颅骨前后位",
        "procedure_other_name": "Skull AP",
        "procedure_description": "颅骨前后位",
        "procedure_description_local": "颅骨前后位",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "procedure_type": "NORMAL",
        "fast_search": false,
        "protocol_laterality": "U",
        "procedure_category": "Adult",
        "modality": "DX",
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      },
      {
        "id": "1",
        "procedure_id": "P0-0001",
        "procedure_code": "P0-0001",
        "procedure_name": "颅骨汤氏位",
        "procedure_name_local": "颅骨汤氏位",
        "procedure_other_name": "Skull Townes View",
        "procedure_description": "颅骨汤氏位",
        "procedure_description_local": "颅骨汤氏位",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "procedure_type": "NORMAL",
        "fast_search": false,
        "protocol_laterality": "U",
        "procedure_category": "Adult",
        "modality": "DX",
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      }
    ]
  }
}

9.4 获取体位列表

GET /dr/api/v1/auth/protocol/view

接口说明

获取体位列表

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
patient_type		从患者类型接口获取
body_part		从身体部位接口获取
is_enabled		true 或 false
page	1	页码
取值范围：>0
page_size	10	行数
取值范围：1-10000

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.ViewList",
    "count": 149,
    "views": [
      {
        "internal_id": "View_DX_T_A_SK_Axial_00",
        "view_id": "View_DX_T_A_SK_Axial_00",
        "view_name": "颅骨前后轴位",
        "view_name_local": "",
        "view_other_name": "Skull AP Axial",
        "view_description": "颅骨前后轴位",
        "view_position": "AP",
        "application": "RAD",
        "anatomic_region": "SKULL",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "view_icon_name": "/Image/Position/Human/m20-063.gif",
        "view_big_icon_name": "/Image/Position/Human/m20-063.large.gif",
        "view_coach_name": "/Image/Position/Human/m20-063.large.gif",
        "modality": "DX",
        "work_station_id": 0,
        "apr_id": "View_DX_T_A_SK_Axial_00",
        "img_proc_id": "View_DX_T_A_SK_Axial_00",
        "config_object": {
          "DX": {
            "CollimatorCenter": "1",
            "CollimatorFilter": "0",
            "CollimatorNoChange": false,
            "CollimatorSize": "14IN(35CM)X17IN(43CM)",
            "CollimatorSizeLength": "17IN",
            "CollimatorSizeWidth": "14IN",
            "ImageHorizontalFlip": "NO",
            "ImageLaterality": "U",
            "ImageRotate": "0",
            "LabelPosition": "LEFT TOP",
            "LabelStyle": "",
            "PatientOrientationColumn": "R",
            "PatientOrientationRow": "L",
            "RatioFactorLength": 0,
            "RatioFactorSize": 0,
            "RatioFactorThickness": 0,
            "RatioFactorWeight": 0,
            "StandPos": "43",
            "TargetEXI": 250,
            "ViewID": "View_DX_T_A_SK_Axial_00"
          }
        },
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      },
      {
        "internal_id": "View_DX_T_A_SK_AP_00",
        "view_id": "View_DX_T_A_SK_AP_00",
        "view_name": "颅骨前后位",
        "view_name_local": "",
        "view_other_name": "Skull AP",
        "view_description": "颅骨前后位",
        "view_position": "AP",
        "application": "RAD",
        "anatomic_region": "SKULL",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "view_icon_name": "/Image/Position/Human/skull.ap.table.x.png",
        "view_big_icon_name": "/Image/Position/Human/skull.ap.table.x.png",
        "view_coach_name": "/Image/Position/Human/skull.ap.table.x.png",
        "modality": "DX",
        "work_station_id": 0,
        "apr_id": "View_DX_T_A_SK_AP_00",
        "img_proc_id": "View_DX_T_A_SK_AP_00",
        "config_object": {
          "DX": {
            "CollimatorCenter": "1",
            "CollimatorFilter": "0",
            "CollimatorNoChange": false,
            "CollimatorSize": "14IN(35CM)X17IN(43CM)",
            "CollimatorSizeLength": "17IN",
            "CollimatorSizeWidth": "14IN",
            "ImageHorizontalFlip": "NO",
            "ImageLaterality": "U",
            "ImageRotate": "0",
            "LabelPosition": "LEFT TOP",
            "LabelStyle": "",
            "PatientOrientationColumn": "R",
            "PatientOrientationRow": "L",
            "RatioFactorLength": 0,
            "RatioFactorSize": 0,
            "RatioFactorThickness": 0,
            "RatioFactorWeight": 0,
            "StandPos": "43",
            "TargetEXI": 250,
            "ViewID": "View_DX_T_A_SK_AP_00"
          }
        },
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      }
    ]
  }
}

9.5 获取体位列表(通过procedure_id)

GET /dr/api/v1/auth/protocol/procedure/{id}/view

接口说明

获取体位列表(通过procedure_id)

地址参数（Path Variable）

参数名称	默认值	描述
id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.ViewList",
    "count": 2,
    "views": [
      {
        "internal_id": "View_DX_T_A_SK_AP_00",
        "view_id": "View_DX_T_A_SK_AP_00",
        "view_name": "颅骨前后位",
        "view_name_local": "",
        "view_other_name": "Skull AP",
        "view_description": "颅骨前后位",
        "view_position": "AP",
        "application": "RAD",
        "anatomic_region": "SKULL",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "view_icon_name": "/Image/Position/Human/skull.ap.table.x.png",
        "view_big_icon_name": "/Image/Position/Human/skull.ap.table.x.png",
        "view_coach_name": "/Image/Position/Human/skull.ap.table.x.png",
        "modality": "DX",
        "work_station_id": 0,
        "apr_id": "View_DX_T_A_SK_AP_00",
        "img_proc_id": "View_DX_T_A_SK_AP_00",
        "config_object": {
          "DX": {
            "CollimatorCenter": "1",
            "CollimatorFilter": "0",
            "CollimatorNoChange": false,
            "CollimatorSize": "14IN(35CM)X17IN(43CM)",
            "CollimatorSizeLength": "17IN",
            "CollimatorSizeWidth": "14IN",
            "ImageHorizontalFlip": "NO",
            "ImageLaterality": "U",
            "ImageRotate": "0",
            "LabelPosition": "LEFT TOP",
            "LabelStyle": "",
            "PatientOrientationColumn": "R",
            "PatientOrientationRow": "L",
            "RatioFactorLength": 0,
            "RatioFactorSize": 0,
            "RatioFactorThickness": 0,
            "RatioFactorWeight": 0,
            "StandPos": "43",
            "TargetEXI": 250,
            "ViewID": "View_DX_T_A_SK_AP_00"
          }
        },
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      },
      {
        "internal_id": "View_DX_T_A_SK_LAT_00",
        "view_id": "View_DX_T_A_SK_LAT_00",
        "view_name": "颅骨左侧位",
        "view_name_local": "",
        "view_other_name": "Skull LAT,left",
        "view_description": "颅骨左侧位",
        "view_position": "LAT",
        "application": "RAD",
        "anatomic_region": "SKULL",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "view_icon_name": "/Image/Position/Human/Skull_T_lat_left.gif",
        "view_big_icon_name": "/Image/Position/Human/Skull_T_lat_left.x.gif",
        "view_coach_name": "/Image/Position/Human/Skull_T_lat_left.x.gif",
        "modality": "DX",
        "work_station_id": 0,
        "apr_id": "View_DX_T_A_SK_LAT_00",
        "img_proc_id": "View_DX_T_A_SK_LAT_00",
        "config_object": {
          "DX": {
            "CollimatorCenter": "1",
            "CollimatorFilter": "0",
            "CollimatorNoChange": false,
            "CollimatorSize": "8IN(20CM)X10IN(25CM)",
            "CollimatorSizeLength": "10IN",
            "CollimatorSizeWidth": "8IN",
            "ImageHorizontalFlip": "NO",
            "ImageLaterality": "U",
            "ImageRotate": "0",
            "LabelPosition": "RIGHT TOP",
            "LabelStyle": "",
            "PatientOrientationColumn": "R",
            "PatientOrientationRow": "L",
            "RatioFactorLength": 0,
            "RatioFactorSize": 0,
            "RatioFactorThickness": 0,
            "RatioFactorWeight": 0,
            "StandPos": "43",
            "TargetEXI": 250,
            "ViewID": "View_DX_T_A_SK_LAT_00"
          }
        },
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      }
    ]
  }
}

9.6 获取体位详情

GET /dr/api/v1/auth/protocol/view/{id}

接口说明

根据ID获取体位详情

地址参数（Path Variable）

参数名称	默认值	描述
id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
patient_type		从患者类型接口获取
body_part		从身体部位接口获取
is_enabled		true 或 false
procedure_id		从协议列表接口获取

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.View",
    "internal_id": "View_DX_T_A_SK_Axial_04",
    "view_id": "View_DX_T_A_SK_Axial_04",
    "view_name": "下颌骨, 闭口",
    "view_name_local": "",
    "view_other_name": "Mandible,jaw close",
    "view_description": "下颌骨, 闭口",
    "view_position": "Axial",
    "application": "RAD",
    "anatomic_region": "Facial bones",
    "patient_type": "Human",
    "body_part_id": "Human_SKULL",
    "view_icon_name": "/Image/Position/Human/m21-082.gif",
    "view_big_icon_name": "/Image/Position/Human/m21-082.large.gif",
    "view_coach_name": "/Image/Position/Human/m21-082.gif",
    "modality": "DX",
    "work_station_id": 1,
    "apr_id": "View_DX_T_A_SK_Axial_04",
    "img_proc_id": "View_DX_T_A_SK_Axial_04",
    "config_object": {
      "DX": {
        "CollimatorCenter": "1",
        "CollimatorFilter": "0",
        "CollimatorNoChange": false,
        "CollimatorSize": "14IN(35CM)X17IN(43CM)",
        "CollimatorSizeLength": "17IN",
        "CollimatorSizeWidth": "14IN",
        "ImageHorizontalFlip": "NO",
        "ImageLaterality": "U",
        "ImageRotate": "0",
        "LabelPosition": "LEFT TOP",
        "LabelStyle": "",
        "PatientOrientationColumn": "R",
        "PatientOrientationRow": "L",
        "RatioFactorLength": 0,
        "RatioFactorSize": 0,
        "RatioFactorThickness": 0,
        "RatioFactorWeight": 0,
        "StandPos": "43",
        "TargetEXI": 250,
        "ViewID": "View_DX_T_A_SK_Axial_04"
      }
    },
    "sort": 1,
    "is_enabled": true,
    "product": "DROS",
    "is_pre_install": true
  }
}

9.7 获取APR详情(通过view_id)

GET /dr/api/v1/auth/protocol/view/{id}/apr

接口说明

根据体位ID获取APR详情

地址参数（Path Variable）

参数名称	默认值	描述
id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
patient_type		从患者类型接口获取
body_part		从身体部位接口获取
is_enabled		true 或 false
procedure_id		从协议列表接口获取

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.AprReply",
    "apr_id": "View_DX_T_A_HD_OBL_01",
    "apr_name": "View_DX_T_A_HD_OBL_01",
    "apr_description": "右手斜位",
    "patient_type": "Human",
    "body_part_id": "Human_UPPER LIMB",
    "view_position": "OBL",
    "category": "EXTREMITIES_MEDIUM",
    "modality": "DX",
    "exposures": [
      {
        "work_station_id": 0,
        "patient_size": "Large",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 55,
            "mA": 80,
            "mAs": 3.2,
            "ms": 40
          }
        }
      },
      {
        "work_station_id": 0,
        "patient_size": "Medium",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 2,
            "ms": 25
          }
        }
      },
      {
        "work_station_id": 0,
        "patient_size": "Paediatric",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 1.6,
            "ms": 20
          }
        }
      },
      {
        "work_station_id": 0,
        "patient_size": "Small",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 2,
            "ms": 25
          }
        }
      },
      {
        "work_station_id": 1,
        "patient_size": "Large",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 55,
            "mA": 80,
            "mAs": 3.2,
            "ms": 40
          }
        }
      },
      {
        "work_station_id": 1,
        "patient_size": "Medium",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 2,
            "ms": 25
          }
        }
      },
      {
        "work_station_id": 1,
        "patient_size": "Paediatric",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 1.6,
            "ms": 20
          }
        }
      },
      {
        "work_station_id": 1,
        "patient_size": "Small",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 2,
            "ms": 25
          }
        }
      }
    ],
    "sort": 0,
    "is_enabled": true,
    "product": "DROS",
    "is_pre_install": true
  }
}

9.8 获取APR详情

GET /dr/api/v1/auth/protocol/apr/{id}

接口说明

根据ID获取APR详情

地址参数（Path Variable）

参数名称	默认值	描述
id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
patient_type		从患者类型接口获取
body_part		从身体部位接口获取
is_enabled		true 或 false
procedure_id		从协议列表接口获取

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.AprReply",
    "apr_id": "View_DX_T_A_HD_OBL_01",
    "apr_name": "View_DX_T_A_HD_OBL_01",
    "apr_description": "右手斜位",
    "patient_type": "Human",
    "body_part_id": "Human_UPPER LIMB",
    "view_position": "OBL",
    "category": "EXTREMITIES_MEDIUM",
    "modality": "DX",
    "exposures": [
      {
        "work_station_id": 0,
        "patient_size": "Large",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 55,
            "mA": 80,
            "mAs": 3.2,
            "ms": 40
          }
        }
      },
      {
        "work_station_id": 0,
        "patient_size": "Medium",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 2,
            "ms": 25
          }
        }
      },
      {
        "work_station_id": 0,
        "patient_size": "Paediatric",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 1.6,
            "ms": 20
          }
        }
      },
      {
        "work_station_id": 0,
        "patient_size": "Small",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 2,
            "ms": 25
          }
        }
      },
      {
        "work_station_id": 1,
        "patient_size": "Large",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 55,
            "mA": 80,
            "mAs": 3.2,
            "ms": 40
          }
        }
      },
      {
        "work_station_id": 1,
        "patient_size": "Medium",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 2,
            "ms": 25
          }
        }
      },
      {
        "work_station_id": 1,
        "patient_size": "Paediatric",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 1.6,
            "ms": 20
          }
        }
      },
      {
        "work_station_id": 1,
        "patient_size": "Small",
        "config_object": {
          "Common": {
            "AECDensity": 0,
            "AECField": "010",
            "AECFilm": 1,
            "Dose": 0,
            "ExposureMode": 0,
            "Focus": 0,
            "TOD": 0,
            "TubeLoad": 0,
            "kV": 50,
            "mA": 80,
            "mAs": 2,
            "ms": 25
          }
        }
      }
    ],
    "sort": 0,
    "is_enabled": true,
    "product": "DROS",
    "is_pre_install": true
  }
}

9.9 获取APR设备信息

GET /dr/api/v1/auth/protocol/apr/{id}/device

接口说明

根据ID获取APR详情

地址参数（Path Variable）

参数名称	默认值	描述
id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
work_station_id		工作位 0 或 1

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.AprDevice",
    "work_station_id": 1,
    "config_object": {
      "Common": {
        "APRNumber": "5",
        "DetectorAngle": 0,
        "FpdAcquisitionMode": "101",
        "FrameRate": 0,
        "GridSpeed": 0,
        "GridType": 2,
        "PositionNumber": "2",
        "SID": 115,
        "Thickness": 1,
        "TubeAngle": 0
      }
    }
  }
}

9.10 获取APR默认曝光参数

GET /dr/api/v1/auth/protocol/apr/{id}/tech

接口说明

根据ID获取APR详情

地址参数（Path Variable）

参数名称	默认值	描述
id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
work_station_id		工作位 0 或 1
patient_size		体型 Large 或 Medium 或 Small

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.TechParam",
    "dp": {
      "SID": 115,
      "GridType": 2,
      "GridSpeed": 0,
      "DetectorAngle": 0,
      "TubeAngle": 0,
      "TubeHeight": 0,
      "APRNumber": "5",
      "PositionNumber": "2",
      "Thickness": 1,
      "FrameRate": 0,
      "LongTimeExp": 0
    },
    "ep": {
      "kV": 70,
      "mA": 125,
      "ms": 100,
      "mAs": 12.5,
      "ExposureMode": 0,
      "Focus": 0,
      "AECFilm": 1,
      "AECField": "010",
      "AECDensity": 0,
      "Dose": 0,
      "TubeLoad": 0,
      "TOD": 0,
      "CompressionThickness": 0
    }
  }
}

10 登记检查信息

POST /dr/api/v1/auth/study

接口说明

登记检查信息

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
accession_number	string	ACC0012345	true	登记号
patient_id	string	PET007	true	患者ID
patient_name	object	Buddy	true	患者名称
patient_english_name	string		false	英文名
patient_former_name	string		false	曾用名
patient_size	string	Large	true	患者体型
patient_age	string	5Y	true	患者年龄
patient_dob	string	2025-06-10T03:12:36.181739Z	true	生日
patient_sex	string		false	性别 M、F、O、U
sex_neutered	string		false	仅宠物绝育状态 ALTERED (绝育) UNALTERED (未绝育)
pregnancy_status	string		false	仅人医妊娠状态 0001 not pregnant 0002 possibly pregnant 0003 definitely pregnant 0004 unknown
owner_name	string		false	仅宠物主人
chip_number	object	CHIP123456789	false	仅宠物芯片号
variety	string	Golden Retriever	false	仅宠物品种描述
is_anaesthesia	string	false	false	bool 麻醉状态
is_sedation	string	false	false	bool 镇定状态
patient_type	string	Human	true	患者种类
ref_physician	string	Dr. Smith (Vet)	false	医师
operator_id	string	OP987	false	操作者
modality	string	DX	true
weight	int32	25	false	体重
thickness	int32	15	false	厚度
length	int32	60	false	身高
study_type	string	Normal	true	类型 Normal 普通 Emergency 紧急
comment	string	Patient presented with limping in right hind leg. Sedation administered.	false	备注
views	array[object]		true	体位列表
⇥ view_id	string	View_DX_T_A_SK_AP_00	true	体位id
⇥ procedure_id	string	P0-0002	true	协议id 如果直接选择的体位，协议id填空字符串

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.study.Study",
    "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482097",
    "study_id": "20250625143339389",
    "public_study_id": "",
    "specific_character_set": "ISO_IR 192",
    "accession_number": "ACC0012345",
    "ref_physician": "Dr. Smith (Vet)",
    "patient_id": "PET007",
    "patient_name": "Buddy (Dog)",
    "patient_english_name": "Buddy en",
    "patient_former_name": "Buddy f",
    "patient_size": "Large",
    "other_patient_ids": "",
    "other_patient_names": "",
    "patient_age": "5Y",
    "patient_dob": "2025-06-10T03:12:36.181739Z",
    "patient_sex": "M",
    "patient_state": "",
    "admitting_time": null,
    "priority": "",
    "reg_source": "",
    "study_description": "",
    "study_start_datetime": "2025-06-25T06:33:39.420606Z",
    "study_end_datetime": null,
    "scheduled_procedure_step_start_date": null,
    "performed_physician": "",
    "study_lock": "Unlocked",
    "folder_path": "",
    "operator_name": "OP987",
    "modality": "DX",
    "weight": 25,
    "thickness": 15,
    "length": 60,
    "patient_type": "Human",
    "study_type": "Normal",
    "owner_name": "owner1",
    "chip_number": "CHIP123456789",
    "variety": "Golden Retriever",
    "is_anaesthesia": true,
    "is_sedation": true,
    "mwl": "",
    "is_exported": false,
    "is_edited": false,
    "is_appended": false,
    "department": "",
    "mapped_status": false,
    "qc_result": false,
    "comment": "Patient presented with limping in right hind leg. Sedation administered.",
    "study_status": "Arrived",
    "sort": 0,
    "product": "DROS",
    "series": [
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482098",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482097",
        "study_id": "20250625143339389",
        "procedure_id": "P0-0002",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "颅骨前后位 + 侧位",
        "performed_protocol_code_value": "P0-0002",
        "sort": 1,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482099",
            "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482098",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482097",
            "secondary_sop_uid": "",
            "study_id": "20250625143339389",
            "view_id": "View_DX_T_A_SK_AP_00",
            "view_description": "颅骨前后位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 1,
            "product": "DROS",
            "is_pre_install": true
          },
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482100",
            "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482098",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482097",
            "secondary_sop_uid": "",
            "study_id": "20250625143339389",
            "view_id": "View_DX_T_A_SK_LAT_00",
            "view_description": "颅骨左侧位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 2,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      },
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482101",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482097",
        "study_id": "20250625143339389",
        "procedure_id": "",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "",
        "performed_protocol_code_value": "",
        "sort": 2,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482102",
            "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482101",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750833219.482097",
            "secondary_sop_uid": "",
            "study_id": "20250625143339389",
            "view_id": "View_DX_T_A_SK_Special_04",
            "view_description": "颅骨汤氏位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 3,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      }
    ]
  }
}

11 变更登记信息

PUT /dr/api/v1/auth/study/{id}

接口说明

变更检查信息 :id 任务ID

地址参数（Path Variable）

参数名称	默认值	描述
id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
accession_number	string	ACC0012345	true	登记号
patient_id	string	PET007	true	患者ID
patient_name	object	Buddy	true	患者名称
patient_english_name	object		false	患者英文名
patient_former_name	string		false	曾用名
patient_size	string	Large	true	患者体型
patient_age	string	5Y	true	患者年龄
patient_dob	string	2025-06-10T03:12:36.181739Z	true	生日
patient_sex	string		true	性别 M、F、O、U
owner_name	string		false	仅宠物主人
chip_number	string	CHIP123456789	false	仅宠物芯片号
variety	string	Golden Retriever	false	仅宠物品种描述
is_anaesthesia	string	false	false	bool 麻醉状态
is_sedation	string	false	false	bool 镇定状态
ref_physician	string	Dr. Smith (Vet)	false	医师
operator_id	string	OP987	false	操作者
weight	int32	25	false	体重
thickness	int32	15	false	厚度
length	int32	60	false	身高
comment	string	Patient presented with limping in right hind leg. Sedation administered.	false	备注

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.study.Study",
    "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482080",
    "study_id": "20250625140057649",
    "public_study_id": "",
    "specific_character_set": "ISO_IR 192",
    "accession_number": "ACC00123451",
    "ref_physician": "Dr. Smith (Vet)1",
    "patient_id": "PET0071",
    "patient_name": "Buddy (Dog)g",
    "patient_english_name": "Buddy ee",
    "patient_former_name": "Buddy ff",
    "patient_size": "Small",
    "other_patient_ids": "",
    "other_patient_names": "",
    "patient_age": "4Y",
    "patient_dob": "2025-06-11T03:12:36.181739Z",
    "patient_sex": "F",
    "patient_state": "",
    "admitting_time": null,
    "priority": "",
    "reg_source": "",
    "study_description": "",
    "study_start_datetime": "2025-06-25T06:00:57.401703Z",
    "study_end_datetime": null,
    "scheduled_procedure_step_start_date": null,
    "performed_physician": "",
    "study_lock": "Unlocked",
    "folder_path": "",
    "operator_name": "OP9871",
    "modality": "DX",
    "weight": 35,
    "thickness": 25,
    "length": 70,
    "patient_type": "Human",
    "study_type": "Normal",
    "owner_name": "owner11",
    "chip_number": "CHIP1234567891",
    "variety": "Golden Retriever1",
    "is_anaesthesia": false,
    "is_sedation": false,
    "mwl": "",
    "is_exported": false,
    "is_edited": false,
    "is_appended": false,
    "department": "",
    "mapped_status": false,
    "qc_result": false,
    "comment": "1Patient presented with limping in right hind leg. Sedation administered.",
    "study_status": "Arrived",
    "sort": 0,
    "product": "DROS",
    "series": [
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482081",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482080",
        "study_id": "20250625140057649",
        "procedure_id": "P0-0002",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "颅骨前后位 + 侧位",
        "performed_protocol_code_value": "P0-0002",
        "sort": 1,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482082",
            "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482081",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482080",
            "secondary_sop_uid": "",
            "study_id": "20250625140057649",
            "view_id": "View_DX_T_A_SK_AP_00",
            "view_description": "颅骨前后位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 1,
            "product": "DROS",
            "is_pre_install": true
          },
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482083",
            "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482081",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482080",
            "secondary_sop_uid": "",
            "study_id": "20250625140057649",
            "view_id": "View_DX_T_A_SK_LAT_00",
            "view_description": "颅骨左侧位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 2,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      },
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482084",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482080",
        "study_id": "20250625140057649",
        "procedure_id": "",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "",
        "performed_protocol_code_value": "",
        "sort": 2,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482085",
            "series_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482084",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.33458.1750831257.482080",
            "secondary_sop_uid": "",
            "study_id": "20250625140057649",
            "view_id": "View_DX_T_A_SK_Special_04",
            "view_description": "颅骨汤氏位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 3,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      }
    ]
  }
}

12 获取检查信息列表

GET /dr/api/v1/auth/study/

接口说明

获取检查信息列表

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTYzOTExNjUsImlkIjozLCJuYW1lIjoiYWRtaW4ifQ.ivwjTzeMXLwJry1iHN8a9hV90ftSgDZF6n8lEfOtTOQ
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求参数(Query Param)

参数名称	默认值	描述
id		模糊搜索
name		模糊搜索
acc_no		模糊搜索
start_time		RFC3339Nano格式
例：2025-06-19T00:00:00.000+08:00
end_time		RFC3339Nano格式
例：2025-06-19T23:59:59.999+08:00
status	Arrived,InProgress	逗号分隔的字符串列表

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.protocol.ViewList",
    "count": 149,
    "views": [
      {
        "internal_id": "View_DX_T_A_SK_Axial_00",
        "view_id": "View_DX_T_A_SK_Axial_00",
        "view_name": "颅骨前后轴位",
        "view_name_local": "",
        "view_other_name": "Skull AP Axial",
        "view_description": "颅骨前后轴位",
        "view_position": "AP",
        "application": "RAD",
        "anatomic_region": "SKULL",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "view_icon_name": "/Image/Position/Human/m20-063.gif",
        "view_big_icon_name": "/Image/Position/Human/m20-063.large.gif",
        "view_coach_name": "/Image/Position/Human/m20-063.large.gif",
        "modality": "DX",
        "work_station_id": 0,
        "apr_id": "View_DX_T_A_SK_Axial_00",
        "img_proc_id": "View_DX_T_A_SK_Axial_00",
        "config_object": {
          "DX": {
            "CollimatorCenter": "1",
            "CollimatorFilter": "0",
            "CollimatorNoChange": false,
            "CollimatorSize": "14IN(35CM)X17IN(43CM)",
            "CollimatorSizeLength": "17IN",
            "CollimatorSizeWidth": "14IN",
            "ImageHorizontalFlip": "NO",
            "ImageLaterality": "U",
            "ImageRotate": "0",
            "LabelPosition": "LEFT TOP",
            "LabelStyle": "",
            "PatientOrientationColumn": "R",
            "PatientOrientationRow": "L",
            "RatioFactorLength": 0,
            "RatioFactorSize": 0,
            "RatioFactorThickness": 0,
            "RatioFactorWeight": 0,
            "StandPos": "43",
            "TargetEXI": 250,
            "ViewID": "View_DX_T_A_SK_Axial_00"
          }
        },
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      },
      {
        "internal_id": "View_DX_T_A_SK_AP_00",
        "view_id": "View_DX_T_A_SK_AP_00",
        "view_name": "颅骨前后位",
        "view_name_local": "",
        "view_other_name": "Skull AP",
        "view_description": "颅骨前后位",
        "view_position": "AP",
        "application": "RAD",
        "anatomic_region": "SKULL",
        "patient_type": "Human",
        "body_part_id": "Human_SKULL",
        "view_icon_name": "/Image/Position/Human/skull.ap.table.x.png",
        "view_big_icon_name": "/Image/Position/Human/skull.ap.table.x.png",
        "view_coach_name": "/Image/Position/Human/skull.ap.table.x.png",
        "modality": "DX",
        "work_station_id": 0,
        "apr_id": "View_DX_T_A_SK_AP_00",
        "img_proc_id": "View_DX_T_A_SK_AP_00",
        "config_object": {
          "DX": {
            "CollimatorCenter": "1",
            "CollimatorFilter": "0",
            "CollimatorNoChange": false,
            "CollimatorSize": "14IN(35CM)X17IN(43CM)",
            "CollimatorSizeLength": "17IN",
            "CollimatorSizeWidth": "14IN",
            "ImageHorizontalFlip": "NO",
            "ImageLaterality": "U",
            "ImageRotate": "0",
            "LabelPosition": "LEFT TOP",
            "LabelStyle": "",
            "PatientOrientationColumn": "R",
            "PatientOrientationRow": "L",
            "RatioFactorLength": 0,
            "RatioFactorSize": 0,
            "RatioFactorThickness": 0,
            "RatioFactorWeight": 0,
            "StandPos": "43",
            "TargetEXI": 250,
            "ViewID": "View_DX_T_A_SK_AP_00"
          }
        },
        "sort": 1,
        "is_enabled": true,
        "product": "DROS",
        "is_pre_install": true
      }
    ]
  }
}

13 获取检查信息

GET /dr/api/v1/auth/study/{id}

接口说明

:id -- 检查信息ID(study_id) 例：20250619164137632

地址参数（Path Variable）

参数名称	默认值	描述
id		study_id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTYxOTU0MDIsImlkIjozLCJuYW1lIjoiYWRtaW4ifQ.jK86cKyAMwfgxPsE6mpvSE1PF99jHrppGJZdB8G9uEw
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.study.StudyReply",
    "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.34708.1750322497.870195",
    "study_id": "20250619164137632",
    "public_study_id": "",
    "specific_character_set": "ISO_IR 192",
    "accession_number": "ACC0012346",
    "ref_physician": "Dr. Smith (Vet)",
    "patient_id": "PET007",
    "patient_name": "Tom",
    "patient_size": "Large",
    "other_patient_ids": "",
    "other_patient_names": "",
    "owner_name": "",
    "patient_age": "5Y",
    "patient_dob": "2025-06-10T03:12:36.181739Z",
    "patient_sex": "M",
    "patient_state": "",
    "admitting_time": null,
    "priority": "",
    "reg_source": "",
    "study_description": "",
    "study_start_datetime": "2025-06-19T08:41:37.894Z",
    "study_end_datetime": null,
    "scheduled_procedure_step_start_date": null,
    "performed_physician": "",
    "study_lock": "Unlocked",
    "folder_path": "",
    "operator_name": "",
    "modality": "DX",
    "weight": 25,
    "thickness": 15,
    "length": 60,
    "patient_type": "Human",
    "study_type": "Normal",
    "mwl": "",
    "is_exported": false,
    "is_edited": false,
    "is_appended": false,
    "department": "",
    "mapped_status": false,
    "qc_result": false,
    "comment": "Patient presented with limping in right hind leg. Sedation administered.",
    "study_status": "Completed",
    "sort": 0,
    "product": "DROS",
    "series": [
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.34708.1750322497.870196",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.34708.1750322497.870195",
        "study_id": "20250619164137632",
        "procedure_id": "P0-0002",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "颅骨前后位 + 侧位",
        "performed_protocol_code_value": "P0-0002",
        "sort": 1,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.4.701601461.34708.1750322497.870197",
            "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.34708.1750322497.870196",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.34708.1750322497.870195",
            "secondary_sop_uid": "",
            "study_id": "20250619164137632",
            "view_id": "View_DX_T_A_SK_AP_00",
            "view_description": "颅骨前后位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 1,
            "product": "DROS",
            "is_pre_install": true
          },
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.4.701601461.34708.1750322497.870198",
            "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.34708.1750322497.870196",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.34708.1750322497.870195",
            "secondary_sop_uid": "",
            "study_id": "20250619164137632",
            "view_id": "View_DX_T_A_SK_LAT_00",
            "view_description": "颅骨左侧位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 2,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      },
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.34708.1750322497.870199",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.34708.1750322497.870195",
        "study_id": "20250619164137632",
        "procedure_id": "",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "",
        "performed_protocol_code_value": "",
        "sort": 2,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.4.701601461.34708.1750322497.870200",
            "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.34708.1750322497.870199",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.34708.1750322497.870195",
            "secondary_sop_uid": "",
            "study_id": "20250619164137632",
            "view_id": "View_DX_T_A_SK_Special_04",
            "view_description": "颅骨汤氏位",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "expose_status": "Unexposed",
            "judged_status": "NotJudged",
            "send_status": "Unsent",
            "storage_status": "NotSaved",
            "sort": 3,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      }
    ]
  }
}

14 获取检查信息状态

GET /dr/api/v1/auth/study/{id}/stat

接口说明

:id -- 检查信息ID(study_id) 例：20250619164137632

地址参数（Path Variable）

参数名称	默认值	描述
id		study_id

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.study.Stat",
    "total": 3,
    "exposed": 1
  }
}

15 删除检查信息(批量)

DELETE /dr/api/v1/auth/study

接口说明

批量删除检查信息

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.study.Stat",
    "total": 3,
    "exposed": 1
  }
}

请求body示例

[
	"20250623110433242",
	"20250623110436888"
]

16 [Study]存储拍摄的急诊患者影像

POST /api/v1/auth/study/portrait

接口说明

存储拍摄的急诊患者影像

地址参数（Path Variable）

参数名称	默认值	描述
drurl

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
instance_uid	string	1.2.276.0.1000000.5.1.4.701601461.19649.1749545373.668671	true	study_id
data	file		true	PNG图片文件

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.task.DcmPath",
    "path": "1.2.276.0.1000000.5.1.5.701601461.33458.1750830395.482043.dcm"
  }
}

17 [Study]批量添加体位和协议

POST /dr/api/v1/auth/image

接口说明

添加体位和协议

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空
study_id	string	20250610164933314	true
views	array[object]		true
⇥ view_id	string	View_DX_T_A_SK_Special_05	true
⇥ procedure_id	string		true

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.study.CreateImageReply",
    "series": [
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.11229.1750069146.245933",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.19649.1749545373.668668",
        "study_id": "20250610164933314",
        "procedure_id": "P0-0002",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "颅骨前后位 + 侧位",
        "performed_protocol_code_value": "P0-0002",
        "sort": 5,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.4.701601461.11229.1750069146.245934",
            "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.11229.1750069146.245933",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.19649.1749545373.668668",
            "secondary_sop_uid": "",
            "study_id": "20250610164933314",
            "view_id": "View_DX_T_A_SK_AP_00",
            "view_description": "颅骨前后位",
            "image_status": "QUEUING",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "sort": 8,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      },
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.11229.1750069146.245935",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.19649.1749545373.668668",
        "study_id": "20250610164933314",
        "procedure_id": "",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "",
        "performed_protocol_code_value": "",
        "sort": 6,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.4.701601461.11229.1750069146.245936",
            "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.11229.1750069146.245935",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.19649.1749545373.668668",
            "secondary_sop_uid": "",
            "study_id": "20250610164933314",
            "view_id": "View_DX_T_A_SK_Special_05",
            "view_description": "颅骨斯氏位",
            "image_status": "QUEUING",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "sort": 9,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      }
    ]
  }
}

示例请求body

{
  "study_id": "20250610164933314",
  "views": [
    {
      "view_id": "View_DX_T_A_SK_AP_00",
      "procedure_id": "P0-0002"
    },
    {
      "view_id": "View_DX_T_A_SK_Special_05",
      "procedure_id": ""
    }
  ]
}

18 [Study]复制体位

POST /dr/api/v1/auth/image/copy

接口说明

复制选中的体位

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
instance_uid	string	1.2.276.0.1000000.5.1.4.701601461.19649.1749545373.668671	true

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.study.CreateImageReply",
    "series": [
      {
        "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.19649.1749545373.668669",
        "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.19649.1749545373.668668",
        "study_id": "20250610164933314",
        "procedure_id": "P0-0002",
        "body_part": "Human_SKULL",
        "performed_datetime": null,
        "performed_protocol_code_meaning": "颅骨前后位 + 侧位",
        "performed_protocol_code_value": "P0-0002",
        "sort": 1,
        "product": "DROS",
        "is_pre_install": true,
        "images": [
          {
            "sop_instance_id": "1.2.276.0.1000000.5.1.4.701601461.11229.1750068918.245928",
            "series_instance_uid": "1.2.276.0.1000000.5.1.3.701601461.19649.1749545373.668669",
            "study_instance_uid": "1.2.276.0.1000000.5.1.2.701601461.19649.1749545373.668668",
            "secondary_sop_uid": "",
            "study_id": "20250610164933314",
            "view_id": "View_DX_T_A_SK_LAT_00",
            "view_description": "颅骨左侧位",
            "image_status": "QUEUING",
            "image_file_path": "",
            "acquisition_mode": "RAD",
            "acquisition_context": null,
            "img_proc_context": null,
            "sort": 3,
            "product": "DROS",
            "is_pre_install": true
          }
        ]
      }
    ]
  }
}

19 [Study]体位重新排序

POST /dr/api/v1/auth/image/sort

接口说明

体位排序

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
study_id	string	20250610164933314	true
sop_instance_uids	array[string]		true

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/google.protobuf.Empty",
    "value": {}
  }
}

示例请求body

{
  "study_id": "20250610164933314",
  "sop_instance_uids": [
		"1.2.276.0.1000000.5.1.4.701601461.19649.1749545373.668670",
		"1.2.276.0.1000000.5.1.4.701601461.19649.1749545373.668671",
		"1.2.276.0.1000000.5.1.4.701601461.19649.1749545373.668673",
		"1.2.276.0.1000000.5.1.4.701601461.11229.1750068819.245927",
		"1.2.276.0.1000000.5.1.4.701601461.11229.1750068918.245928",
		"1.2.276.0.1000000.5.1.4.701601461.11229.1750069085.245930",
		"1.2.276.0.1000000.5.1.4.701601461.11229.1750069085.245932",
		"1.2.276.0.1000000.5.1.4.701601461.11229.1750069146.245934",
		"1.2.276.0.1000000.5.1.4.701601461.11229.1750069146.245936"
	]
}

20 [Study]删除体位

DELETE /dr/api/v1/auth/image/:id

接口说明

删除study中的体位，:id为image的sop_instance_uid

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/google.protobuf.Empty",
    "value": {}
  }
}

示例请求 DELETE {{drurl}}/api/v1/auth/image/1.2.276.0.1000000.5.1.4.701601461.19649.1749539018.668478

21 [Device]打开设备

POST /api/v1/auth/device/open

接口说明

打开设备

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
deviceUri	string	DIOS/DEVICE/Generator	true

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/google.protobuf.Empty",
    "value": {}
  }
}

22 [Device]执行Action

POST /api/v1/auth/device/action

接口说明

执行Action

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空
deviceUri	string	DIOS/DEVICE/Generator	true
reqName	string	IncParam_KV	true
reqParam	string		true
reqTransaction	string		true
reqClientID	string		true

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/google.protobuf.Empty",
    "value": {}
  }
}

23 [Task]开始检查

POST /api/v1/auth/task/inspection/start

接口说明

进入曝光页面时调用，告知后端当前开始的是哪个检查

地址参数（Path Variable）

参数名称	默认值	描述
drurl

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
instance_uid	string	1.2.276.0.1000000.5.1.4.701601461.19649.1749545373.668671	true	sop_instance_uid

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/google.protobuf.Empty",
    "value": {}
  }
}

24 [Task]获取全局状态

GET /api/v1/auth/task/inspection/status

接口说明

获取当前发生器、探测器和后端服务的状态

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "成功",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/dr.task.TaskGlobalStatus",
    "gen_status": "GENERATOR_STATUS_STANDBY",
    "gen_ready": true,
    "fpd_status": "DETECTOR_STATUS_STANDBY",
    "fpd_ready": true,
    "insp_status": "TASK_Ready",
    "insp_ready": true,
    "all_ready": true
  }
}

状态变化时会推送mqtt消息

Topic: MODULE/TASK/STATUS/GLOBAL

{
  "GENStatus": "GENERATOR_STATUS_STANDBY",
  "GENReady": true,
  "FPDStatus": "DETECTOR_STATUS_STANDBY",
  "FPDReady": true,
  "InspStatus": "TASK_Ready",
  "InspReady": true,
  "AllReady": true
}

25 [Task]软曝光(包含状态推送说明)

POST /api/v1/auth/task/inspection/trigger

接口说明

曝光页面调用触发曝光

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "data": {},
  "description": "Success",
  "solution": ""
}

图像处理过程会通过mqtt推送进度和状态，会按顺序推送以下状态，重点关注成功和失败状态，其他状态按需使用

TASK_RecvRaw 已获取原图
TASK_RecvMask 已获取mask
TASK_RecvEnhance 已完成增强
TASK_RecvForeground 已获取前景mask
TASK_RecvApply 已完成遮罩mask
TASK_Success 成功存储dcm
TASK_Failure 失败 message包含失败原因

主题(topic)：**MODULE/TASK/IMGPROC/PROGRESS**

举例：(已获取原图)

{
  "message": "",
  "sop": "20250801150247",
  "status": "TASK_RecvRaw"
}

成功：dcm字段为结果文件名，thumbnail字段为缩略图

{
  "dcm": "20250801150247.dcm",
  "message": "",
  "sop": "20250801150247",
  "status": "TASK_Success",
  "thumbnail": "20250801150247.webp"
}

失败：message包含失败原因

{
  "message": "open testfile/circle_3072_3072_11.tif: The system cannot find the file specified.",
  "sop": "20250801150942",
  "status": "TASK_Failure"
}

26 [Task]接受拒绝图像

POST /api/v1/auth/task/inspection/judge

接口说明

接受或者拒绝当前图像

地址参数（Path Variable）

参数名称	默认值	描述
drurl

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
instance_uid	object	1.2.276.0.1000000.5.1.4.701601461.19649.1749545373.668671	true	sop_instance_uid
accept	boolean	false	true

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/google.protobuf.Empty",
    "value": {}
  }
}

27 [Task]挂起或完成study

POST /api/v1/auth/task/inspection/leave

接口说明

挂起或完成study

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
study_id	object	20250625143339389	true	study_id
study_status	boolean	Completed	true	InProgress 或 Completed

响应体

● 200: OK 响应数据格式：JSON

{
  "code": "0x000000",
  "description": "Success",
  "solution": "",
  "data": {
    "@type": "type.googleapis.com/google.protobuf.Empty",
    "value": {}
  }
}

28 获取dcm文件

GET /api/v1/auth/image/dcm/{dcmfilename}

接口说明

获取dcm文件

地址参数（Path Variable）

参数名称	默认值	描述
dcmfilename		dcm文件名

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：File

文件

29 获取缩略图文件

GET /api/v1/auth/image/thumbnail/{filename}

接口说明

获取缩略图文件

地址参数（Path Variable）

参数名称	默认值	描述
filename		缩略图文件名

请求头

参数名称	默认值	描述
Authorization	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NTEyNzc5NzAsImlkIjoxLCJuYW1lIjoiYWRtaW4ifQ.ooTGwBXaNhtunbKbpqteWbjDwJLjnRmSIl80r5dp1pY
Language	en	en 或 zh
Product	DROS	DROS 或 VETDROS
Source	Electron	Electron 或 Browser 或 Android

响应体

● 200: OK 响应数据格式：File

文件

DR.md 122 KB 文件歷史 原始文件

DR

2 获取软件信息

接口说明

响应体

3 获取用户列表

接口说明

响应体

4 获取示意图

接口说明

响应体

5 登陆

请求头

请求体(Request Body)

响应体

6 修改密码

接口说明

请求头

请求体(Request Body)

响应体

7 获取选项

请求头

请求参数(Query Param)

响应体

8 获取配置项

接口说明

请求头

请求参数(Query Param)

响应体

uri可用值

9 协议

9.1 获取患者类型

请求头

请求参数(Query Param)

响应体

9.2 获取身体部位

接口说明

请求头

请求参数(Query Param)

响应体

9.3 获取协议列表

接口说明

请求头

请求参数(Query Param)

响应体

9.4 获取体位列表

接口说明

请求头

请求参数(Query Param)

响应体

9.5 获取体位列表(通过procedure_id)

接口说明

地址参数（Path Variable）

请求头

响应体

9.6 获取体位详情

接口说明

地址参数（Path Variable）

请求头

请求参数(Query Param)

响应体

9.7 获取APR详情(通过view_id)

接口说明

地址参数（Path Variable）

请求头

请求参数(Query Param)

响应体

9.8 获取APR详情

接口说明

地址参数（Path Variable）

请求头

请求参数(Query Param)

响应体

9.9 获取APR设备信息

接口说明

地址参数（Path Variable）

请求头

请求参数(Query Param)

响应体

9.10 获取APR默认曝光参数

DR.md 122 KB

文件歷史原始文件