以下是handler描述

Handler 1: 获取患者类型

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/patient_type

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

handler 2:

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/body_part

query params

patient_type:从患者类型接口获取
modality:暂时只有DX
is_enabled:true 或 false

Response Status: 200 (OK)

Response Data: Returns a 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
      }
    ]
  }
}

Dynamic Behavior: None

Delay: None

Error Handling: None

Handler 3: 获取软件信息

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/pub/software_info

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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": ""
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 4: 获取用户列表

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/pub/users

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 5: 获取示意图

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/pub/Image/xxx/xxx/xxx

Response Status: 200 (OK)

Response Data: Returns a File

Example:

图片数据

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 6: 登陆

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/pub/login

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 7: 修改密码

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/settings/password

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 8: 获取选项

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/resource/options

Query Params

group: basic
flag: sex_full

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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"
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 9: 获取配置项

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/resource/config

Query Params

uri:

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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"
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 10: 获取患者类型

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/patient_type

Query Params

is_enabled: true 或 false

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 11: 获取身体部位

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/body_part

Query Params

patient_type: 从患者类型接口获取
modality: 暂时只有DX
is_enabled: true 或 false

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 12: 获取协议列表

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/procedure

Query Params

patient_type: 从患者类型接口获取
body_part: 从身体部位接口获取
procedure_type: NORMAL 或 EMERGENCY
is_enabled: true 或 false
page: 页码 (取值范围：>0)
page_size: 行数 (取值范围：1-10000)

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 13: 获取体位列表

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/view

Query Params

patient_type: 从患者类型接口获取
body_part: 从身体部位接口获取
is_enabled: true 或 false
page: 页码 (取值范围：>0)
page_size: 行数 (取值范围：1-10000)

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 14: 获取体位列表(通过procedure_id)

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/procedure/{id}/view

Path Variable

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 15: 获取体位详情

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/view/{id}

Path Variable

Query Params

patient_type: 从患者类型接口获取
body_part: 从身体部位接口获取
is_enabled: true 或 false
procedure_id: 从协议列表接口获取

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 16: 获取APR详情(通过view_id)

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/view/{id}/apr

Path Variable

Query Params

patient_type: 从患者类型接口获取
body_part: 从身体部位接口获取
is_enabled: true 或 false
procedure_id: 从协议列表接口获取

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 17: 获取APR详情

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/apr/{id}

Path Variable

Query Params

patient_type: 从患者类型接口获取
body_part: 从身体部位接口获取
is_enabled: true 或 false
procedure_id: 从协议列表接口获取

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 18: 获取APR设备信息

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/apr/{id}/device

Path Variable

Query Params

work_station_id: 工作位 0 或 1

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
      }
    }
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 19: 获取APR默认曝光参数

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/protocol/apr/{id}/tech

Path Variable

Query Params

work_station_id: 工作位 0 或 1
patient_size: 体型 Large 或 Medium 或 Small

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
    }
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 20: 登记检查信息

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/study

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填空字符串

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
          }
        ]
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 21: 变更登记信息

HTTP Method: PUT

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/study/{id}

Path Variable

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	备注

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
          }
        ]
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 22: 获取检查信息列表

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/study/

Query Params

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, Completed)
page: 页码 (取值范围：>0)
page_size: 行数 (取值范围：1-10000)

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 23: 获取检查信息

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/study/{id}

Path Variable

id: study_id

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
          }
        ]
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 24: 获取检查信息状态

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/study/{id}/stat

Path Variable

id: study_id

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 25: 删除检查信息(批量)

HTTP Method: DELETE

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/study

Request Body

Example:

["20250623110433242", "20250623110436888"]

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 26: 存储拍摄的急诊患者影像

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/study/portrait

Path Variable

drurl:

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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"
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 27: 批量添加体位和协议

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/image

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
          }
        ]
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 28: 复制体位

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/image/copy

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
          }
        ]
      }
    ]
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 29: 体位重新排序

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/image/sort

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 30: 删除体位

HTTP Method: DELETE

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /dr/api/v1/auth/image/:id

Path Variable

id: image的sop_instance_uid

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 31: 打开设备

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/device/open

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 32: 执行Action

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/device/action

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 33: 开始检查

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/task/inspection/start

Path Variable

drurl:

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 34: 获取全局状态

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/task/inspection/status

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

{
  "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
  }
}

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 35: 软曝光

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/task/inspection/trigger

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 36: 接受拒绝图像

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/task/inspection/judge

Path Variable

drurl:

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 37: 挂起或完成study

HTTP Method: POST

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/task/inspection/leave

Request Body

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

Response Status: 200 (OK)

Response Data: Returns a JSON

Example:

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

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 38: 获取dcm文件

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/image/dcm/{dcmfilename}

Path Variable

dcmfilename: dcm文件名

Response Status: 200 (OK)

Response Data: Returns a File

Example:

文件

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 39: 获取缩略图文件

HTTP Method: GET

Headers

Authorization
Language: en 或 zh
Product: DROS 或 VETDROS
Source: Electron 或 Browser 或 Android

Endpoint URL: /api/v1/auth/image/thumbnail/{filename}

Path Variable

filename: 缩略图文件名

Response Status: 200 (OK)

Response Data: Returns a File

Example:

文件

handlers.md 88 KB Verlauf Originalformat

以下是handler描述

Handler 1: 获取患者类型

HTTP Method: GET

Headers

Endpoint URL: /dr/api/v1/auth/protocol/patient_type

Response Status: 200 (OK)

Response Data: Returns a JSON

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

handler 2:

HTTP Method: GET

Headers

Endpoint URL: /dr/api/v1/auth/protocol/body_part

query params

Response Status: 200 (OK)

Response Data: Returns a JSON

Dynamic Behavior: None

Delay: None

Error Handling: None

Handler 3: 获取软件信息

HTTP Method: GET

Headers

Endpoint URL: /dr/api/v1/pub/software_info

Response Status: 200 (OK)

Response Data: Returns a JSON

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 4: 获取用户列表

HTTP Method: GET

Headers

Endpoint URL: /dr/api/v1/pub/users

Response Status: 200 (OK)

Response Data: Returns a JSON

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 5: 获取示意图

HTTP Method: GET

Headers

Endpoint URL: /dr/api/v1/pub/Image/xxx/xxx/xxx

Response Status: 200 (OK)

Response Data: Returns a File

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 6: 登陆

HTTP Method: POST

Headers

Endpoint URL: /dr/api/v1/pub/login

Request Body

Response Status: 200 (OK)

Response Data: Returns a JSON

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 7: 修改密码

HTTP Method: POST

Headers

Endpoint URL: /api/v1/auth/settings/password

Request Body

Response Status: 200 (OK)

Response Data: Returns a JSON

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 8: 获取选项

HTTP Method: GET

Headers

Endpoint URL: /dr/api/v1/auth/resource/options

Query Params

Response Status: 200 (OK)

Response Data: Returns a JSON

Dynamic Behavior: None

Delay: 500ms to simulate network latency

Error Handling: None

Handler 9: 获取配置项

HTTP Method: GET

handlers.md 88 KB

Verlauf Originalformat