1 接口简介

1.1 编写目的

本接口规范旨在满足客户业务系统从ACal检定/校准系统软件中读取检测数据、写入被检器具信息等业务数据的需要。

1.2 读者对象

本文档的读者对象是计量业务系统的软件开发人员。

1.3 适用范围

该接口规范适用于ACal网络版和ACal专业版软件。

ℹ️选型建议：使用ACal软件的电脑数量多于1台时，建议与ACal网络版的中心数据库进行中心到中心的一次性对接。

1.4 接口协议

客户接口采用HTTP POST通讯接口，可以使用几乎任何客户端和任何编程语言与ACal的客户接口进行交互。

1.5 编码规范

编码统一使用UTF-8。

1.6 报文格式

统一使用Json格式。

2 准备工作

2.1 安装ACal软件

部署接口服务前，请先安装ACal软件，如果是ACal网络版，请在服务器上同时安装“ACal服务器管理软件”和“ACal检定/校准系统软件”。

若无正式版软件，可打开以下链接获取专业版试用安装包：

如版本过低（1.5.260803及以上版本），请下载并安装软件最新升级包：

查看软件版本的方法：客户端主界面右下角状态栏。

2.2 安装接口服务

软件默认没有启用API接口服务，需要用户手动安装。

操作方法:运行ACal软件安装目录下APIServiceManager.exe,弹出登录窗口，输入密码"api"，进入主界面。

软件配置中显示本机已安装ACal的软件版本、安装位置、数据库位置及数据库名称。用户依次点击"Install"和"Start "按钮完成服务部署工作。

说明：服务安装完成后，以后每次开机时自动启动服务，无需每次手动启动。

注意：若Windows 8以下操作系统无法运行接口服务程序，请先下载并安装.NET Framework4.5.1或以上版本。

接口测试：

点击"Test"按钮，自动在浏览器打开Swagger。

2.3 典型对接流程

流程说明：

进入业务平台的“任务/计划管理”模块，选择待检测的任务，点击“下载”按钮，调用ACal API下发待检器具信息。

进入ACal校准界面，选择待检器具，执行检测并产生检测结果。

进入业务平台的“任务/计划管理”模块，点击“采集数据”按钮，调用ACal API获取检测数据。

完成系统对接后，证书的生成与管理由业务平台负责，因此，开发检测数据的对接通常只关注“API Functions/Test Records”目录即可。

2.4 检测数据接口选型

在开发检测数据接口前，请根据业务系统的特点选型接口：

序号	数据类型	适用业务系统	说明
1	字典数据	提供在线编制证书功能编制证书时先选择类似Excel表单的模板再录入检测数据。
2	Excel文件	支持上传离线证书文件

3 接口调试

本接口文档仅用于帮助业务平台开发人员快速了解 ACal API 的接口能力和设计集成方案。
下载 Apifox 接口调试工具，使用下面给定的用户登录并进入 ACal API 项目后，可以快速调试接口，同时获得更多接口测试用例。

Apifox 接口调试工具下载地址：

用户名：

密码：

4 接口身份验证

详见 Accounts/README。

Quickstart

1 接口简介#

1.1 编写目的#

1.2 读者对象#

1.3 适用范围#

1.4 接口协议#

1.5 编码规范#

1.6 报文格式#

2 准备工作#

2.1 安装ACal软件#

2.2 安装接口服务#

2.3 典型对接流程#

2.4 检测数据接口选型#

3 接口调试#

4 接口身份验证#