仪器对接接口示范.docVIP

南京三方检测仪对接接口文档_v1.0 （以恒温PCR为示范） 说明 https请求方式：请求格式url（请求分POST,GET请求,按照HTTPS格式进行请求封装）：https://ip:port/project/function.do 所有的请求只能使用HTTPS的方式进行服务器访问 登录认证：所有对服务器接口的访问都必须经过登录认证。 登录认证流程：见接口1 动态配置服务器等参数是由“版本列表选择”提供的 接口详情请见接口1说明 获得以下参数：服务器相关ip,port,project areaVersionCode 其他相关traceurl,dbCode（具体查数据录入的溯源码那一块） 所有接口必须附带三个参数,其中areaVersionCode、deviceid、token： areaVersionCode = XXXX(接入标识码)接口2返回 deviceid = XXXX(接入仪器唯一标识) token = XXXXXXXXXXXXXX(接口1获取) 所有返回值以json格式返回，形如{respCode:1000000,respMsg:操作成功,resultList:[ {..}, {..},{..},.. ]} respCode为1000000时代表请求成功，其他的代表请求失败，直接提示respMsg的错误信息,resultList在请求成功并且有返回值时，存放返回值 5. 需要仪器上所有可编辑的内容，包括来源产地，样品编号，检测对象，检测项目，检测摊位号在一次检测完成后保存该值，下次进入检测画面自动显示上一次检测录入的信息 6. 上传失败需允许用户重新编辑录入信息，重新上传 7. 视频监控部分具体参看视频监控接口协议文档 接口安全机制 安全认证接口（非业务、涉及接口安全机制） 说明：本接口不涉及任何业务，属于服务器安全认证的步骤，本接口通过预先分配的账号、密码进行访问，并对账号、密码定期进行更换，通过本接口获得账号、密码的TOKEN令牌，所有其他接口的访问都必须携带该TOKEN令牌，TOKEN令牌有限期为15分钟，会在每次进行接口访问的时候对有效期进行延长更新。 方法名 getTOKEN.do 描述 GET 接收：trilateralusername 验证用登录名 是 base64加密 trilateralpassword 验证用密码 是 base64加密 输出： 参数名 说明 备注 respCode 返回调用状态码 1000000：操作成功， 1000001：操作失败， 1000002：网络错误， 1000003：验证失败， 1000004：参数为空， 1000005：自定义， 1000006：数据库异常 respMsg 操作信息 成功时返回空； 失败时返回错误信息； result 返回结果 result: 7703a593f7004c73c7d79f 输出示例：{respCode:1000000,respMsg:操作成功,:7703a593f7004c73c7d79f } 版本列表选择（非业务、涉及接口灵活性） 说明：第一个接口会有一个固定的url+接口名（如ip:port/projectname/ getAreaVersionList.do?type= xxxx）来获取仪器设备之后的各个接口访问服务器信息,实现服务端的动态配置，以防服务器进行迁移之后，仪器必须升级来切换服务器地址 方法名 固定地址getAreaVersionList.do 描述 GET 接收：type 登录名 是 需要和接口提供方配合进行添加，用于区分不同的仪器种类 输出： 参数名 说明 备注 respCode 返回调用状态码 1000000：操作成功， 1000001：操作失败， 1000002：网络错误， 1000003：验证失败， 1000004：参数为空， 1000005：自定义， 1000006：数据库异常 respMsg 操作信息 成功时返回空； 失败时返回错误信息； resultList 返回结果 ip：仪器后续接口应该访问的ip port:仪器后续接口访问的端口， areaVersionCode：仪器后续接口所需的areaVersionCode参数 versionName:仪器当前版本描述信息 project：仪器后续接口所需的project参数 id:序号，暂无用处 chkForward：描述信息，暂无用处 traceurl:接口6上传完后打印信息使用，dbCode：接口6traceNo生成规则使用 输出示例：{respCode:1000000,respMsg:操作成功,resultList:[{port:,id:1,versionCode: