清洗机接口

【概述】

对接方式

1、第三方系统上传设备运行参数数据：先登陆，获取Token，再通过Token上传相应数据即可；

【签名与登陆】

对接说明

1、追溯系统提供WebAPI；

2、数据提交方式：Post；

3、数据格式：JSON；

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

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

数据格式

1、post和返回格式相同；

签名说明

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();

}

成功时返回报文正文说明

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

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

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

示例：

{

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

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

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

"OK": true

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

  }

}

失败时返回报文正文说明

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

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

【业务函数】

根据自身业务情况，单笔上传和整批次上传选其一进行开发即可。如果客户要求实时显示设备运行数据（如温度曲线和压力曲线），则必须实时采用单笔上传。

【单笔上传】

传入参数

返回内容

【整批次上传】

传入参数

Recs列表内容：至少包括6条记录；

返回内容