C300-OpenAPI

对接设备数据

POST

/api/msg/v1/m/status

设备数据采集统一对外开放接口
⚠️ 仅接收设备最近5min运行参数（通过参数【runtime】检验），不符合范围数据将自动丢弃！

请求参数

Body 参数application/json

gatewayId

string

设备网关ID

必需

MES系统维护设备基础数据唯一对应设备网关ID

gatewayStatus

integer

网关状态

必需

1代表连接成功、2代表连接失败

gatewayFailureCode

integer

网关失败代码

必需

自定义数值型

machineFailureCode

integer

设备失败代码

必需

自定义数值型

machineStatus

integer

设备状态

必需

0->未连接 1->关机 2->空闲 3->调机 4->生产 5->故障

runJson

object

设备参数Json

必需

Map结构，默认为空；
Key信息对应采集参数标识符，Value对应采集参数值，仅允许接收String、Number类型；

param01

string

必需

param02

integer

必需

param03

number

必需

planQty

integer

计划生产数量

必需

必须大于等于0

actualQty

integer

实际生产数量

必需

必须大于等于0

runSpeed

integer

运行速度

必需

runtime

integer

runtime

必需

数据采集当前时间戳，使用Unix时间戳（毫秒）格式

示例

{
    "actualQty": 99,
    "gatewayFailureCode": 0,
    "gatewayId": "10020223",
    "gatewayStatus": 0,
    "machineFailureCode": 0,
    "machineStatus": 4,
    "planQty": 0,
    "runJson": {
        "param01": 1,
        "param02": 0.2,
        "param03": 0.03
    },
    "runSpeed": 3,
    "runtime": 1639444089439
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sit.newcoretech.com/api/msg/v1/m/status' \
--header 'Content-Type: application/json' \
--data-raw '{
    "actualQty": 99,
    "gatewayFailureCode": 0,
    "gatewayId": "10020223",
    "gatewayStatus": 0,
    "machineFailureCode": 0,
    "machineStatus": 4,
    "planQty": 0,
    "runJson": {
        "param01": 1,
        "param02": 0.2,
        "param03": 0.03
    },
    "runSpeed": 3,
    "runtime": 1639444089439
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

示例

{
    "code": 200,
    "message": "成功"
}

查询设备

创建员工