智能钢筋集中加工配送系统 - 标准集成协议

1. 数据定义

1.1 返回结果标准格式定义

处理成功

{
    "timestamp": 1620908055696,
    "status": 200,
    "message": "处理成功",
    "data":{}
}

处理出错

{
    "timestamp": 1620908055696,
    "status": 500,
    "message": "出现错误",
    "error": "Internal Server Error",
    "exception": "cn.rmes.core.exception.RBizException",
    "path": "xxxx/open/api/v1/storage/temp/bills"
}

2.标准接口

2.1 设备远控-停止

接口说明:

远程停止设备

交互时序：

sequenceDiagram
三方->>三方: 识别违规操作
三方->>RMES: 调用设备远控-停止
RMES->>RMES: 检查三方签名
RMES->>RMES: 解析url用户名称，模拟可信身份
RMES->>RMES: 检查用户权限
RMES->>RMES: 检查租户权限
RMES->>RMES: 检查设备远控是否开启
RMES->>RMES: 停止设备
RMES--)三方: 返回结果

接口地址：

https://xxxx/open/api/v1/iot/equipments/stop

请求方式：

POST

参数说明：

名称	参数	类型	取值范围	长度	必须	备注
三方平台标识	platform	string			Y	由RMES颁发的三方平台标识 非法的标识不会通过认证
数据	data	object			Y	数据,详见下方参数格式

参数格式

{
    "platform":"smartJ",
    "data":{
        "user":"18000000001",//可信的用户，在RMES有操作权限
        "iotId":"xxxxxxxxxxxxxxxxxx" //设备唯一标识
    }
}