成都市建设综合项目工程材料检测监管系统接口说明指导书.doc

成城市建设工程材料检测监管系统接口说明书V1.1 编制单位：成全部鹏业软件股份 编制时间：-10-9 编制人：古军 联络电话： 版本 *状态 简明说明 日期 1.0 A 创建 /10/9 1.1 M 修改 /10/21 *状态：A——增加，M——修改，P——公布，D——删除 1.1版本变更具体内容： （1）“3.6保留汇报”输入参数修改了 “混凝土立方体试件抗压强度检测汇报”格式。 （2）“3.6保留汇报”输入参数增加了 “混凝土抗渗性能检测汇报”、“钢筋焊接力学性能检测汇报”、“混凝土抗折强度检测汇报”格式。 （3）“3.3获取样品信息”输出参数增加了“钢筋焊接头检测”、“混凝土抗压检测”、“混凝土抗渗检测”、“混凝土抗折检测”格式 目录 TOC \o 1-3 \h \z \u 1、账号及密码申请 3 2、服务调用 3 3、接口描述 3 3.1身份认证 3 3.2身份注销 4 3.3获取样品信息 5 3.4获取送检单信息 11 3.5保留送检单 13 3.6保留汇报 15 3.4短信通知 26 1、账号及密码申请 向平台申请第三方应用访问账号及密码。 2、服务调用 第三方应用访问平台API时，首先应提供有效用户名和密码（MD5加密）进行身份认证，认证成功后将取得一个token；后续全部其它API调用全部必需提供有效token；一个token含有一定时效性，token失效后需要重新进行身份认证才能进行API调用。 3、接口描述 3.1身份认证 方法署名 /// param name=loginId登录Id/param /// param name=passWord登录密码/param string Login (string loginId, string passWord) 输入参数 loginId和password向平台申请；其中password需要做以下加密：用前缀字符串“P%y2Kja” 加上明文密码，然后用MD5算法加密后再进行Base64编码。 C#： public static string GetPasswordHash(string Password) { if (!string.IsNullOrEmpty(Password)) { MD5 md = new MD5CryptoServiceProvider(); byte[] bytes = Encoding.Default.GetBytes(P%y2Kja + Password); return Convert.ToBase64String(md.ComputeHash(bytes)); } return Password; } 测试明文：123456 密文：unFckLlqULw2o6cC92KDmg== 输出参数 返回字符串格式以下： Message ResultOK/Result Data9Qd7GVKQmGVKUezyID8VZg==/Data /Message 认证成功，Result为OK，Data为token； 认证失败，Result为错误消息。 另注：除正常返回错误消息外，还有一个未知错误，比如：超时，断网等，这类错误返回格式为： Error_Result Code=-1 Msg 操作超时在 System.Net.HttpWebRequest.GetResponse()... /Msg /Error_Result 服务地址 （1）测试地址： http:// 39:8015/Service/SampleManagementWebSvr.assx/Login?loginId=userpassWord=123456 （2）正式地址： 待定 3.2身份注销 方法署名 /// param name=token标识符/param string Logout(string token) 输入参数 token是调用Login方法成功以后返回值。 输出参数 返回字符串格式以下： Message ResultOK/Result Data/Data /Message 注销成功，Result为OK； 注销失败，Result为错误消息。 服务地址 （1）测试地址： http:// 39:8015/Service/SampleManagementWebSvr.assx/ Logout?token= （2）正式地址： 待定 3.3获取样品信息 方法署名