鑫澳康API接口文档：校园智能系统技术接口详解

鑫澳康的API接口文档详细介绍了校园食堂智能化软硬件系统的接口规则和技术细节，该系统主要包括云消费机、二维码收款机、智慧公交、智慧菜市场、云门禁和云水控等多种产品。这些接口主要围绕微信支付和支付宝两种主流支付方式展开，提供了一套统一的开发接口规范。 1. **传输方式**： API接口采用HTTP协议进行数据传输，确保了跨平台兼容性和安全性。 2. **提交方式**： 提交请求时，开发者必须使用POST方法，这有利于保持数据的完整性和结构清晰。 3. **数据格式**： 请求和响应的数据格式均为JSON格式，便于解析和处理，提高了接口的易用性。 4. **签名算法**： 鑫澳康使用MD5加密方式来验证请求的合法性，通过字段名按ASCII码排序，构造URL键值对形式的字符串，加上密钥进行MD5运算，然后转为大写，形成签名（signValue）。 5. **签名规则**： 签名是接口安全的关键，通过特定步骤对所有请求参数进行排序并组合，再加入密钥进行加密，确保只有合法请求才能通过校验。 6. **接口列表**： 提供了针对微信支付（如 `/api/terminal/ocom/trade/wepay/pay` 和查询交易状态的 `/api/terminal/ocom/trade/wepay/query` 等）以及支付宝支付（如 `/api/terminal/ocom/trade/alipay/pay` 和 `/api/terminal/ocom/trade/alipay/query`）的一系列接口，涵盖了支付、订单查询、取消订单和退款等核心功能。 7. **请求参数**： 每个接口都有特定的请求参数，如`nonce_str`（随机字符串，用于防重放攻击）、`sign`（签名）、`device_no`（终端设备号）、`auth_code`（付款授权码）和`goods_desc`（商品描述），这些参数的完整性对接口调用至关重要。 8. **返回参数**： 调用接口后，服务端会返回相应的数据，具体返回参数取决于所执行的操作，例如订单状态、交易结果等。 9. **错误列表**： 提供了参数的详细说明，包括参数名称、类型、是否必填、示例值和备注，帮助开发者理解参数的正确使用和可能遇到的问题。 这份接口文档为开发者提供了开发校园智能硬件应用所需的清晰指导，使得接入鑫澳康的支付服务变得相对简单，只需遵循指定的规则和参数规范即可实现无缝集成。