通讯协议结构
采用http/https(根据系统环境决定)
POST方式
参数传输采用JSON BODY格式
编码:UTF8
测试前置条件
提供测试、生成环境的接口URL,以及为调用端分配appId和对应的secret。
报文格式
请求报文:
| 字段简称 | 类型 | 参数说明 | 备注 |
|---|---|---|---|
| appId | 是 | 应用ID | rfid_bi_001 |
| dataType | String | Data字段类型(必填) | string: string格式; |
| data | String | 业务内容字串(必填) | 业务相关数据都会在下面的业务报文中描述 |
先把业务报文按json格式生成;
把json格式进行Base64编码成字符串。|
|timestamp|long|时间戳(毫秒)|接收到请求的时间和本字段时间戳不能超过10分钟,否则按签名校验失败。|
|sign|String|签名|签名计算方法:把data内容(Base64编码)、时间戳、secret(另外提供)进行拼接计算出md5值,并转换成十六进制字符串(不区分大小写)。
2、Md5(dataBase64Str+timestamp+secret)
3、把md5结果转换成十六进制字符串|
请求报文示例:
{
“appId”:”rfid_bi_001”,
“dataType”:”string”,
“timestamp”:1740794491001,
“sign”:”3eddd516c9aa7690dcffd2f690b29f35”,
“data”:”eyJ0aW1lIjoiMjAyNTAzMDExMDAxMzEifQ==”