Domů Procházet Nápověda
Přihlásit se
ddx
/
dros
1
0
Rozštěpit 0
Soubory Úkoly 0 Pull Requesty 0 Wiki
Strom: da3d85aebf
Větve Značky
dros
/
mocks
/
DR.md

DR.md 122 KB
Historie Surový

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 可选项

basic apr_cbo| |flag|sex_full|basic: ---- sex_full ---- patient_size |

响应体

● 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 逗号分隔的字符串列表

可选值： Arrived InProgress Completed| |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
      }
    ]
  }
}

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

文件