手麻系统接口

一. 目的

本文档指导第三方系统对接追溯系统，实现目标：

1、追溯系统的物品包关联到病人；

2、第三方系统获取物品包相关追溯信息；

3、追溯系统获取相关病人信息和手术信息；

二. 对接说明

第三方系统（如手麻系统）开发一个器械包登记页面，用户在该页面扫描器械包条码后第三方系统通过WebAPI获取物品包详细信息，当用户提交保存时，第三方系统保存器械包相关信息的同时，应把手术相关信息提交给追溯系统。

1、追溯系统提供WebAPI；

2、数据提交方式：Post；

3、数据格式：JSON；

4、数据传输格式：utf-8；

5、对接地址：现场配置，如：http://192.168.x.x:12345/api.ashx；

三. 数据格式

post和返回格式相同；

1. 签名说明

sign=md5(dateTime.ToString("yyyy-MM-dd HH:mm:ss")   "|"   rndCode  "|"   sKey   "|"   dataLng)

1、md5的时候把字符串按GBK2312的方式编码后参与计算；

2、sKey:现场分配；

参考代码（c#）：

/// <summary>

/// 返回sign

/// </summary>

/// <param name="dtime">流水时间</param>

/// <param name="dataLng">流水正文长度</param>

/// <param name="sKey">系统分配的sKey</param>

/// <returns></returns>

public static string GetMD5(DateTime dtime, int dataLng,string sKey)

{

    //获取需要加密的字符串

    string encypStr = dtime.ToString("yyyy-MM-dd HH:mm:ss")   "|"   Guid.NewGuid().ToString("N")   "|"   sKey   "|"   dataLng;

    //返回加密后的内容

    return System.BitConverter.ToString((new MD5CryptoServiceProvider()).ComputeHash(Encoding.GetEncoding("GB2312").GetBytes(encypStr))).ToUpper();

}

2. 成功时返回报文正文说明

{... ... "OK":true,  ... ... }

成功时报文正文里必有：OK:true

其它内容参见各函数说明；

示例：

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

"OK": true

...... （有可能不存在其它参数）

  }

}

3. 失败时返回报文正文说明

{... ..."OK":false,"Message":"错误说明", ... ...}

失败时报文正文里必有：OK:false 及 Message；

Message里表示失败原因，如果有用户界面，该失败原因可直接向用户显示；

示例：

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

    "OK": false,

    "Message": "???"

  }

}

四. 登陆

传入参数

返回内容

示例：

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

    "menukey": "login.webonekey",

    "username": "???",

    "nodecode": "???"

  }

}

实例：

{"data":"{\"menukey\":\"login.webonekey\",\"username\":\"621764\",\"nodecode\":\"741A2E10-5FF2-4C66-AE2F-00124887765D\"}","dateTime":"2021-09-02 16:10:49","rndCode":"31f5d485-71b1-44c3-ab29-9f376bcd62be","dataLng":99,"sign":"B380C2D9AD401A21989D406057218419"}

里面没有换行符，因显示的原因产生了换行

五. 通过条码号换取物品包信息

传入参数

返回内容

qx内容

示例：

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

    "menukey": "liuchen.yxwpInfoMoreFromCode",

    "gxtoken": "???",

    "codeText": "???"

  }

}

实例：

{"data":"{\"menukey\":\"liuchen.yxwpInfoMoreFromCode\",\"gxtoken\":\"0cde985b-f954-44e4-bc53-230e83bb1630\",\"codeText\":\"312305\"}","dateTime":"2021-09-02 16:16:41","rndCode":"1bc489b3-52f3-447e-b3cd-b15550cb60de","dataLng":111,"sign":"A54A42E3EACF2ABC14F6AB5550F1AA5F"}

里面没有换行符，因显示的原因产生了换行

六. 向追溯系统设置病人信息

传入参数

部分字段如果医院没有特别的要求，可以填写空，但必须要有这些字段。

返回内容

示例

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

    "menukey": "liuchen.yxwpInfoMoreFromCodeSet",

    "sysID": "???",

    "brName": "???",

    ......

  }

}

实例：

七. 取消设置病人信息

传入参数

返回内容

示例

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

    "menukey": "liuchen.liuchenYXWPChangeSave",

    "idList": "???",

    "changeType": "???",

    "newValueType": "???",

    "newValueMemo": "",

    ......

  }

}