成都市建设关键工程材料检测监管系统接口专项说明书.docx

成都市建设工程材料检测监管系统接口阐明书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获取样品信息”输出参数增长了“钢筋焊接头检测”、“混凝土抗压检测”、“混凝土抗渗检测”、“混凝土抗折检测”格式

目录
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%y2K&ja” 加上明文密码，然后用MD5算法加密后再进行Base64编码。

C#：
public static string GetPasswordHash(string Password)
{
if (!string.IsNullOrEmpty(Password))
{
MD5 md = new MD5CryptoServiceProvider();
byte[] bytes = Encoding.Default.GetBytes("P%y2K&ja" + Password);
return Convert.ToBase64String(md.ComputeHash(bytes));
}
return Password;
}

测试明文：123456
密文：unFckLlqULw2o6cC92KDmg==

输出参数
返回字符串格式如下：
<Message>
<Result>OK</Result>
<Data>9Qd7GVKQmGVKUezyID8VZg==</Data>
</Message>
认证成功，Result为OK，Data为token；
认证失败，Result为错误消息。

另注：除正常返回错误旳消息外，尚有一种未知错误，例如：超时，断网等，此类错误返回格式为：
<Error_Result Code="-1">
<Msg>
操作超时在 System.Net.HttpWebRequest.GetResponse()...
</Msg>
</Error_Result>
服务地址
（1）测试地址：
http:// 118.122.92.139:8015/Service/SampleManagementWebSvr.assx/Login?loginId=user&passWord=123456
（2）正式地址：
待定
3.2身份注销
措施签名
/// <param name="token">标记符</param>
string Logout(string token)
输入参数
token是调用Login措施成功之后旳返回值。
输出参数
返回字符串格式如下：
<Message>
<Result>OK</Result>
<Data></Data>
</Message>
注销成功，Result为OK；
注销失败，Result为错误消息。
服务地址
（1）测试地址：
http:// 118.122.92.139:8015/Service/SampleManagementWebSvr.assx/ Logout?token=
（2）正式地址：
待定
3.3获取样品信息
措施签名
/// <summary>
/// 获取样品信息
/// </summary>
/// <param name="token">顾客标记</param>
/// <param name="number">样品编号</param>
string GetSampleInfo(string token, string number)
输入参数
token：是调用Login措施成功之后旳返回值。
number：样品编号。可以扫描如下二维码获取。

输出参数
调用失败，返回错误消息格式如下：
<Error_Result Code="-1">
<Msg>
操作超时在 System.Net.HttpWebRequest.GetResponse()...
</Msg>
</Error_Result>
调用成功，返回字符串格式如下：
（1）钢筋原材检测：
<送检单>
<送检编号>-SJ010002</送检编号>
<送检单类型>钢筋原材检测</送检单类型>
<工程名称>南城都会（四期）</工程名称>
<工程地址>四川省成都市武侯区益州大道北段</工程地址>
<检测性质>送样委托检测</检测性质>
<钢筋种类>热轧带肋钢筋</钢筋种类>
<组数>2</组数>
<与否复检>否</与否复检>
<见证人>刘晓峰</见证人>
<见证编号>710</见证编号>
<见证单位>四川省中冶建设工程监理有限责任公司</见证单位>
<进场数量>60</进场数量>
<送检单位名称>四川蓝灵交通设施工程有限责任公司</送检单位名称>
<送检日期>-10-10 10:03:13</送检日期>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<钢筋种类>热轧带肋钢筋</钢筋种类>
<工程部位>一层、梁</工程部位>
<公称直径>1</公称直径>
<牌号>HRB335</牌号>
<钢筋级别>一级</钢筋级别>
<生产厂家>济宁国弘机械科技有限公司</生产厂家>
<出厂日期>-10-9 20:32:49</出厂日期>
<炉号>-0001</炉号>
<代表数量>2</代表数量>
<与否通过冷拉调直>是</与否通过冷拉调直>
</样品>
</样品信息>
</送检单>

送检单阐明：

名称
类型
阐明
1.
送检编号
string

2.
工程名称
string

3.
工程地址
string

4.
工程部位
string

5.
检测性质
string

6.
钢筋种类
string

7.
组数
int

8.
与否复检
string

9.
见证人
string

10.
见证编号
string

11.
见证单位
string

12.
进场数量
double

13.
样品信息

样品信息。参见“样品”元素

“样品”阐明
序号
名称
类型
阐明
1.
样品编号
string

2.
工程部位
string

3.
工程部位
double

4.
牌号
string

5.
钢筋级别
string

6.
生产厂家
string

7.
出厂日期
datetime

8.
炉号
string
炉号（批号）
9.
代表数量
double

10.
与否通过冷拉调直
string

（2）钢筋焊接头检测：
<送检单>
<送检编号>-SJ010002</送检编号>
<送检单类型>钢筋焊接头检测</送检单类型>
<工程名称>南城都会（四期）</工程名称>
<工程地址>四川省成都市武侯区益州大道北段</工程地址>
<检测性质>送样委托检测</检测性质>
<钢筋种类>热轧带肋钢筋</钢筋种类>
<组数>2</组数>
<与否复检>否</与否复检>
<见证人>刘晓峰</见证人>
<见证编号>710</见证编号>
<见证单位>四川省中冶建设工程监理有限责任公司</见证单位>
<进场数量>60</进场数量>
<送检单位名称>四川蓝灵交通设施工程有限责任公司</送检单位名称>
<送检日期>-10-10 10:03:13</送检日期>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<钢筋种类>热轧带肋钢筋</钢筋种类>
<工程部位>一层、梁</工程部位>
<公称直径>1</公称直径>
<牌号>HRB335</牌号>
<生产厂家>济宁国弘机械科技有限公司</生产厂家>
<出厂日期>-10-9 20:30:29</出厂日期>
<炉号>-0001</炉号>
<接头数量>2</接头数量>
<焊接类型>焊接类型</焊接类型>
<预埋件T型接头>预埋件T型接头</预埋件T型接头>
<焊条焊剂型号>焊条焊剂型号</焊条焊剂型号>
<焊工姓名>张三</焊工姓名>
<焊工证号>No.123</焊工证号>
</样品>
</样品信息>
</送检单>
（3）混凝土抗压检测：
<送检单>
<送检编号>-SJ010002</送检编号>
<送检单类型>混凝土抗压</送检单类型>
<工程名称>南城都会（四期）</工程名称>
<工程地址>四川省成都市武侯区益州大道北段</工程地址>
<检测性质>送样委托检测</检测性质>
<组数>1</组数>
<与否复检>否</与否复检>
<见证人>刘晓峰</见证人>
<见证编号>710</见证编号>
<见证单位>四川省中冶建设工程监理有限责任公司</见证单位>
<进场数量>60</进场数量>
<送检单位名称>四川蓝灵交通设施工程有限责任公司</送检单位名称>
<送检日期>-10-10 10:03:13</送检日期>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<工程部位>一层、梁</工程部位>
<设计级别>一级</设计级别>
<成型日期>-10-9 20:33:17</成型日期>
<混凝土类型>XXXX</混凝土类型>
<试件尺寸>1x1x0.5</试件尺寸>
<规定龄期>3</规定龄期>
<养护条件>养护条件</养护条件>
</样品>
</样品信息>
</送检单>
（4）混凝土抗渗检测：
<送检单>
<送检编号>-SJ010002</送检编号>
<送检单类型>钢筋焊接头检测</送检单类型>
<工程名称>南城都会（四期）</工程名称>
<工程地址>四川省成都市武侯区益州大道北段</工程地址>
<检测性质>送样委托检测</检测性质>
<组数>1</组数>
<与否复检>否</与否复检>
<见证人>刘晓峰</见证人>
<见证编号>710</见证编号>
<见证单位>四川省中冶建设工程监理有限责任公司</见证单位>
<进场数量>60</进场数量>
<送检单位名称>四川蓝灵交通设施工程有限责任公司</送检单位名称>
<送检日期>-10-10 10:03:13</送检日期>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<工程部位>一层、梁</工程部位>
<强度级别>一级</强度级别>
<成型日期>-10-9 20:33:38</成型日期>
<抗渗级别>一级</抗渗级别>
<规定龄期>3</规定龄期>
<养护条件>养护条件</养护条件>
</样品>
</样品信息>
</送检单>
（5）混凝土抗折检测：
<送检单>
<送检编号>-SJ010002</送检编号>
<送检单类型>钢筋焊接头检测</送检单类型>
<工程名称>南城都会（四期）</工程名称>
<工程地址>四川省成都市武侯区益州大道北段</工程地址>
<检测性质>送样委托检测</检测性质>
<组数>1</组数>
<与否复检>否</与否复检>
<见证人>刘晓峰</见证人>
<见证编号>710</见证编号>
<见证单位>四川省中冶建设工程监理有限责任公司</见证单位>
<进场数量>60</进场数量>
<送检单位名称>四川蓝灵交通设施工程有限责任公司</送检单位名称>
<送检日期>-10-10 10:03:13</送检日期>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<工程部位>一层、梁</工程部位>
<设计级别>一级</设计级别>
<成型日期>-10-9 20:33:51</成型日期>
<试件尺寸>1mmx1mmx0.5mm</试件尺寸>
<规定龄期>3</规定龄期>
</样品>
</样品信息>
</送检单>
服务地址
（1）测试地址：
http:// 118.122.92.139:8015/Service/SampleManagementWebSvr.assx/ GetSampleInfo?token=& number =
（2）正式地址：
待定

3.4获取送检单信息
措施签名
/// <summary>
/// 获取送检单信息
/// </summary>
/// <param name="token">顾客标记</param>
/// <param name="number">送检单编号</param>
string GetInspectionSheetInfo(string token, string number)
输入参数
token：是调用Login措施成功之后旳返回值。
number：送检单编号。
输出参数
调用失败，返回错误消息格式如下：
<Error_Result Code="-1">
<Msg>
操作超时在 System.Net.HttpWebRequest.GetResponse()...
</Msg>
</Error_Result>
调用成功，返回字符串格式如下：
（1）钢筋原材检测：
<送检单>
<送检编号>-SJ010002</送检编号>
<送检单类型>钢筋原材检测</送检单类型>
<工程名称>南城都会（四期）</工程名称>
<工程地址>四川省成都市武侯区益州大道北段</工程地址>
<检测性质>送样委托检测</检测性质>
<钢筋种类>热轧带肋钢筋</钢筋种类>
<组数>2</组数>
<与否复检>否</与否复检>
<见证人>刘晓峰</见证人>
<见证编号>710</见证编号>
<见证单位>四川省中冶建设工程监理有限责任公司</见证单位>
<进场数量>60</进场数量>
<送检单位名称>四川蓝灵交通设施工程有限责任公司</送检单位名称>
<送检日期>-10-10 10:03:13</送检日期>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<钢筋种类>热轧带肋钢筋</钢筋种类>
<工程部位>一层、梁</工程部位>
<公称直径>1</公称直径>
<牌号>HRB335</牌号>
<钢筋级别>一级</钢筋级别>
<生产厂家>济宁国弘机械科技有限公司</生产厂家>
<出厂日期>-10-9 20:32:49</出厂日期>
<炉号>-0001</炉号>
<代表数量>2</代表数量>
<与否通过冷拉调直>是</与否通过冷拉调直>
</样品>
<样品>
<样品编号>-SJ010002-02</样品编号>
<钢筋种类>热轧带肋钢筋</钢筋种类>
<工程部位>一层、梁</工程部位>
<公称直径>1</公称直径>
<牌号>HRB335</牌号>
<钢筋级别>一级</钢筋级别>
<生产厂家>济宁国弘机械科技有限公司</生产厂家>
<出厂日期>-10-9 20:32:49</出厂日期>
<炉号>-0001</炉号>
<代表数量>2</代表数量>
<与否通过冷拉调直>是</与否通过冷拉调直>
</样品>
</样品信息>
</送检单>
（2）钢筋焊接头检测：
参见“3.3获取样品信息”
（3）混凝土抗压检测：
参见“3.3获取样品信息”
（4）混凝土抗渗检测：
参见“3.3获取样品信息”
（5）混凝土抗折检测：
参见“3.3获取样品信息”
服务地址
（1）测试地址：
http:// 118.122.92.139:8015/Service/SampleManagementWebSvr.assx/ GetInspectionSheetInfo?token=& number =
（2）正式地址：
待定

3.5保存送检单
措施签名
/ /// <summary>
/// 保存送检单（收样后调用）
/// </summary>
/// <param name="token">顾客标记</param>
/// <param name="inspectionNumber">送检单编号</param>
/// <param name="data">送检单信息</param>
string SaveInspectionSheetInfo(string token, string inspectionNumber, string data);
输入参数
token：是调用Login措施成功之后旳返回值。
inspectionNumber：送检单编号
data：送检单信息。通过“Post”方式上传。上传前要做url按gb2312编码。格式如下：
<送检单>
<委托编号>xxx</委托编号>
<委托日期>-10-19</委托日期>
<检测费用>xx</检测费用>
<根据原则>xxxxx</根据原则>
<收样人>xxx</收样人>
<收样日期>-10-19</收样日期>
</送检单>
序号
名称
类型
阐明
1.
委托编号
string

2.
委托日期
datetime

3.
检测费用
double

4.
根据原则
string

5.
收样人
string

6.
收样日期
datetime

输出参数
返回字符串格式如下：
<Message>
<Result>OK</Result>
<Data></Data>
</Message>
调用成功，Result为OK；
调用失败，Result为错误消息。

服务地址
（1）测试地址：
http:// 118.122.92.139:8015/Service/SampleManagementWebSvr.assx/ SaveInspectionSheetInfo?token=& inspectionNumber =& data=
（2）正式地址：
待定
3.6保存报告
措施签名
/// <summary>
/// 保存报告单
/// </summary>
/// <param name="token">顾客标记</param>
/// <param name="inspectionNumber">送检单编号</param>
/// <param name="data">报告信息</param>
/// <returns></returns>
string SaveTestReportInfo(string token, string inspectionNumber, string data);
输入参数
token：是调用Login措施成功之后旳返回值。
inspectionNumber：送检单编号
data：报告数据。
（1）钢筋原材料力学性能检测报告：
<报告单>
<报告单类型>钢筋原材检测</报告单类型>
<报告编号>-JC010002</报告编号>
<检测机构名称>四川省鑫川建筑工程检测有限公司</检测机构名称>
<检测机构地址>成都市青羊区东马道街20号</检测机构地址>
<检测机构邮编>610200</检测机构邮编>
<检测机构电话></检测机构电话>
<检测机构传真></检测机构传真>
<委托单位名称>四川蓝灵交通设施工程有限责任公司</委托单位名称>
<委托编号>No0001</委托编号>
<送样人>刘晓峰</送样人>
<委托日期>-10-10 10:03:13</委托日期>
<工程名称>南城都会（四期）</工程名称>
<来样方式>有见证送样</来样方式>
<检测性质>xxx</检测性质>
<钢筋种类>热轧带肋钢筋</钢筋种类>
<见证人>刘晓峰</见证人>
<检测日期>-10-10 10:03:13</检测日期>
<报告日期>-10-10 10:03:13</报告日期>
<根据原则>《钢筋混凝土用钢第1部分：热轧光圆钢筋》（GB1499.1-）</根据原则>
<结论>该样品所检参数符合《钢筋混凝土用钢第1部分：热轧光圆钢筋》（GB1499.1-）规定</结论>
<备注>--</备注>
<声明>检测报告未加盖“CMA章”和“检测资质专业章”无效</声明>
<审批>魏飞</审批>
<校核>雷波</校核>
<主检>王国军</主检>
<送检单编号>-SJ010002</送检单编号>
<检测成果>0</检测成果>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<牌号>HRB335</牌号>
<生产厂家>济宁国弘机械科技有限公司</生产厂家>
<代表数量>2</代表数量>
<工程部位>一层、梁</工程部位>
<试件信息>
<试件>
<试件编号>1</试件编号>
<屈服强度>
<原则值>≥300</原则值>
<实测值>344</实测值>
</屈服强度>
<抗拉强度>
<原则值>≥420</原则值>
<实测值>458</实测值>
</抗拉强度>
<强屈比></强屈比>
<屈标比></屈标比>
<最大力总伸长率></最大力总伸长率>
<伸长率>
<原则值>≥25.0</原则值>
<实测值>35.0</实测值>
</伸长率>
<弯曲实验>
<弯芯直径> d=a </弯芯直径>
<弯曲角度> 180度</弯曲角度>
<弯曲成果>无裂纹</弯曲成果>
</弯曲实验>
</试件>
<试件>
<试件编号>2</试件编号>
<屈服强度>
<原则值>≥300</原则值>
<实测值>344</实测值>
</屈服强度>
<抗拉强度>
<原则值>≥420</原则值>
<实测值>458</实测值>
</抗拉强度>
<强屈比></强屈比>
<屈标比></屈标比>
<最大力总伸长率></最大力总伸长率>
<伸长率>
<原则值>≥25.0</原则值>
<实测值>35.0</实测值>
</伸长率>
<弯曲实验>
<弯芯直径> d=a </弯芯直径>
<弯曲角度> 180度</弯曲角度>
<弯曲成果>无裂纹</弯曲成果>
</弯曲实验>
</试件>
<试件>...</试件>
...
</试件信息>
<重量偏差>
<原则值>±7</原则值>
<实测值>+3.0</实测值>
</重量偏差>
</样品>
<样品>...</样品>
...
</样品信息>
</报告单>

报告单信息：
序号
名称
类型
阐明
1.
报告单类型
string

2.
报告编号
string

3.
检测机构名称
string

4.
检测机构地址
string

5.
检测机构邮编
string

6.
检测机构电话
string

7.
检测机构传真
string

8.
委托单位名称
string

9.
委托编号
string

10.
送样人
string

11.
委托日期
datetime

12.
工程名称
string

13.
来样方式
string

14.
检测性质
注:-11-5增长
string

15.
钢筋种类
string

16.
见证人
string

17.
检测日期
datetime

18.
报告日期
datetime

19.
根据原则
string

20.
结论
string

21.
结论
string

22.
声明
string

23.
审批
string

24.
校核
string

25.
主检
string

26.
送检单编号
string

27.
检测成果
int
0-无结论,1-合格、2-不合格
28.
样品信息

该元素下涉及1到多种“样品”元素
（2）混凝土立方体试件抗压强度检测报告
<报告单>
<报告单类型>混凝土立方体试件抗压强度检测报告</报告单类型>
<报告编号>-JC010002</报告编号>
<检测机构名称>四川省鑫川建筑工程检测有限公司</检测机构名称>
<检测机构地址>成都市青羊区东马道街20号</检测机构地址>
<检测机构邮编>610200</检测机构邮编>
<检测机构电话></检测机构电话>
<检测机构传真></检测机构传真>
<委托单位名称>四川蓝灵交通设施工程有限责任公司</委托单位名称>
<委托编号>No0001</委托编号>
<送样人>刘晓峰</送样人>
<委托日期>-10-10 10:03:13</委托日期>
<工程名称>南城都会（四期）</工程名称>
<来样方式>有见证送样</来样方式>
<检测性质>xxxx</检测性质>
<见证人>刘晓峰</见证人>
<检测日期>-10-10 10:03:13</检测日期>
<报告日期>-10-10 10:03:13</报告日期>
<根据原则>xxxxxx</根据原则>
<备注>--</备注>
<声明>xxxxx</声明>
<审批>魏飞</审批>
<校核>雷波</校核>
<主检>王国军</主检>
<送检单编号>-SJ010002</送检单编号>
<检测成果>0</检测成果>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<成型日期>-10-9 20:33:17</成型日期>
<工程部位>一层、梁</工程部位>
<设计级别>一级</设计级别>
<规定龄期>3</规定龄期>
<试件尺寸>1x1x0.5</试件尺寸>
<试件信息>
<试件>
<试件编号>1</试件编号>
<破坏载荷></破坏载荷>
<抗压强度单个值></抗压强度单个值>
</试件>
<试件>
<试件编号>2</试件编号>
<破坏载荷></破坏载荷>
<抗压强度单个值></抗压强度单个值>
</试件>
<试件>
<试件编号>3</试件编号>
<破坏载荷></破坏载荷>
<抗压强度单个值></抗压强度单个值>
</试件>
</试件信息>
<抗压强度代表值></抗压强度代表值>
</样品>
</样品信息>
</报告单>

（3）混凝土抗渗性能检测报告
<报告单>
<报告单类型>钢筋原材检测</报告单类型>
<报告编号>-JC010002</报告编号>
<检测机构名称>四川省鑫川建筑工程检测有限公司</检测机构名称>
<检测机构地址>成都市青羊区东马道街20号</检测机构地址>
<检测机构邮编>610200</检测机构邮编>
<检测机构电话></检测机构电话>
<检测机构传真></检测机构传真>
<委托单位名称>四川蓝灵交通设施工程有限责任公司</委托单位名称>
<委托编号>No0001</委托编号>
<送样人>刘晓峰</送样人>
<委托日期>-10-10 10:03:13</委托日期>
<工程名称>南城都会（四期）</工程名称>
<来样方式>有见证送样</来样方式>
<检测性质>热轧带肋钢筋</检测性质>
<见证人>刘晓峰</见证人>
<检测日期>-10-10 10:03:13</检测日期>
<报告日期>-10-10 10:03:13</报告日期>
<根据原则>《钢筋混凝土用钢第1部分：热轧光圆钢筋》（GB1499.1-）</根据原则>
<备注>--</备注>
<声明>检测报告未加盖“CMA章”和“检测资质专业章”无效</声明>
<审批>魏飞</审批>
<校核>雷波</校核>
<主检>王国军</主检>
<送检单编号>-SJ010002</送检单编号>
<检测成果>0</检测成果>
<样品信息>
<样品>
<样品编号>-SJ010002-01</样品编号>
<工程部位>一层、梁</工程部位>
<强度级别>一级</强度级别>
<成型日期>-10-9 20:33:38</成型日期>
<抗渗级别>一级</抗渗级别>
<规定龄期>3</规定龄期>
<检测成果>
<检测项>
<加压时间>
<月></月>