1.微信对接
文档: 需求为:用户样本信息变更后,可以通过微信模板消息主动推送给用户。 1.绑定信息(待议) 主动推送模板消息需要区分那个样本对应那个微信粉丝,故而需要先绑定样本信息到粉丝账号。 1)原本存在的问题 用户信息缺失。 根据陈伟描述,有2个问题:一是有的用户不会输入自己的姓名、电话、身份证、地址中的某几项,二是有的用户虽然输入了相关信息,服务器设计中数据库表里面字段都有,但是业务部门没有录入。 具体为:电话(肯定不录)、身份证(医学的不录)、地址(不录)、姓名(基本都录入); 2)上午商议结果存在问题: 商议结果:依靠条形码来区分用户; 问题:条形码如果是连续,则单纯用条形码来查询报告会泄露个人隐私; 建议:采用姓名+条形码的方式查询;(如果可行建议确保用户电话信息录入,以电话号码来查询,更好记忆)
3)接口设计:
请求连接:http://ip:port/project/sample_info.php或者http://ip:port/project/sample_info.do
请求方式:post
请求参数:
code(string类型,12位)
name(string类型,长度最多15位)
返回格式:json
返回信息:是否合法用户
{
"errcode":错误编码
"errmsg":错误信息
}
返回示例:
{
"errcode":0,
"errmsg":"ok",
}
错误编码:
-1:系统繁忙
0:正常
10001:缺乏必要参数
10002:参数不正确
10003:服务器错误
10004:不合法的请求地址(请求来源校验,仅51touxi.com的请求可以获取信息)
2.状态改变通知接口
获取某类型全部样本信息
连接:http://ip:port/project/url
请求方式:post
请求参数:
type:请求信息类型
page:第几页
type: "new_arrive"新收样本 "tested"质检通过的样本 "re_send"质检未通过,需要重发的样本 "reported"新出报告样本 "paper_report"纸质样本 page:默认第一页,每页最多20条 返回参数格式:json 返回参数: errcode:错误编码 datatype:数据类型 datanum:数据数量 page:当前样本页码 total:样本页码总数 data:各个样本信息
具体样本信息:
report_code样本条形码
remark其他信息
(信息尽量进精简)
返回参数示例:
{
errcode:0
datatype:"new_arrive";
datanum:2;
page:1
total:2
data:
{ report_code:"Z201603105252",
receive_time:"2015-01-03 10:23:22",
remark:"该样本===="
},
{ report_code:"Z201603105252",
receive_time:"2015-01-03 10:23:22",
remark:"该样本===="
}
}
错误编码信息同上