市疾控中心实验室信息管理系统接口文档v2.0.docx

重庆市CDC实验室管理系统对接区县信息接口文档

疾控中心实验室系统

接口文档

编制日期：2023年6月

重庆市CDC实验室管理系统对接区县信息接口文档

修改记录

编号

版本

日期

描述

作者/修改者

审核者

1

V1.0

2023-06-07

新建

2

V1.1

2023-07-04

变更

3

V1.2

2023-07-24

变更

4

V1.3

2023-08-02

变更

V1.1变更内容

1、数据包新增des加密步骤

2、仪器所属科室orgName更名为belongDept，specification、equipAssess、equipDescription字段

长度变更为4000

3、订单ordtaskList中status字段长度改为12，orgName更名为deptName

V1.2变更内容

1、增加业务类型附录（5.3）

2、testList（检测项目能力列表）修改部分字段含义

standsrdName字段含义修改为：检验依据(检验标准名称+检验标准章节编号+检验标准方法名称)

sectName字段含义修改为：检验标准方法名称

methodName字段含义修改为：检验标准名称(标准号+标准名称)

V1.3变更内容

1、删除沙盒环境

2、已检测受理单数据接口中，删除部分字段

Acceptorgname

Acceptorgid

Company

3、已检测受理单数据接口中，修改部分字段

dateSend字段改为必填

4、检测受理单数据接口中，新增部分字段

certificateType

Certificate

Ontact

V2.0变更内容

重庆市CDC实验室管理系统对接区县信息接口文档

1、5.1数据变更

2、5.2数据变更

3、5.3数据变更

重庆市CDC实验室管理系统对接区县信息接口文档

目录

第一章接口定义 1

1.1接口说明 1

1.2接口地址 1

1.3接口流程 1

1.4接口响应统一样式 2

第二章接口列表 2

2.1获取发放令牌(TOKEN)接口 2

2.2上传检测业务能力接口 3

2.3上传仪器设备信息接口 6

2.4上传已检测受理单数据接口 9

第三章加密案例 14

第四章响应码表 18

第五章区县对接参考字典 19

5.1对接项目分类及项目名称 19

5.2对接样品分类 73

5.3对接业务类型 75

重庆市CDC实验室管理系统对接区县信息接口文档

说明

其实验室信息管理系统提供方等共同使用，其中接口提供方和接口使用方共同遵守下述接口的参数及约定。

重庆市CDC实验室管理系统对接区县信息接口文档

第一章接口定义

1.1接口说明

文档中所有接口方案提供方均为三维天地；

文档中所有接口调用方均为区县疾控中心；

接口按文档约定按时开发，对于接口返回值均需按照以下方式返回接口调用方（区县疾控中心），不

可返回不在接口约定范围之外的状态码、异常信息等。

1.2接口地址

采用HTTP请求方式，提供如下地址供各区县疾控中心联调及上线。

生产环境URL：00:9012/cqcdc/

1.3接口流程

第1页

重庆市CDC实验室管理系统对接区县信息接口文档

第2页

1.4接口响应统一样式

格式：Json

{

code:xxxx,

msg:说明信息,

data:Object

}

说明：

code：统一返回响应码（具体见响应码表）

msg：简要返回信息说明，比如成功或失败

data：如果接口有数据返回，该字段才有值，否则为空

第二章接口列表

2.1获取发放令牌(token)接口

接口描述：此接口用于获取发放token，获取token后，业务接口对接操作都需在请求头中携带token值，每次获取的token过期时间为3小时。重复调用授权接口，接口提供方应返回新的token，同时老

token失效。

请求方式：POST

接口地址：环境URL+/open/lims/module/bp/external-interfice/auth/getToken

请求头：Content-Type：application/json;charset=utf-8

请求参数：

字段名称

字段类型

是否必填

说明

appId

String

是

自定义机构标识（三维提供）

securityKey

String

是

分配的密钥（三维提供）

请求示例：

重庆市CDC实验室管理系统对接区县信息接口文档

第3页

{

appId:101,

securityKey:3829a4c1

}

返回示例：