联网开放平台
  1. 机床管理
联网开放平台
  • 0.开发前必读
  • a.使用柏楚demo快速生成请求头
  • b.手动生成请求头
  • 1.可支配机床
  • 2.api配额以及频率限制
  • 全局异常码
  • 切割设备接口
    • 机床管理
      • 机床列表
      • 机床详细信息
      • 机床状态变更记录
    • 实时数据
      • 机床运行状态
      • 机床当前报警列表
      • 机床加工中的任务
      • 机床切割系统的实时状态
    • 历史数据
      • 分页加工记录
    • 统计信息
      • 一段时间统计数据汇总
      • 每日切割长度
      • 每日加工时长
      • 每日开气时长
      • 每日开光时长
      • 每日穿孔数
      • 每日空闲时长
      • 每日空移长度
      • 机床产能
      • 每日报警时长
    • 任务管理
      • 上传切割任务
  • 焊接设备接口
    • 机床管理
      • 机床列表
        POST
      • 机床详细信息
        POST
      • 机床状态变更记录
        POST
    • 实时数据
      • 机床运行状态
    • 历史数据
      • 分页焊接加工记录
    • 统计信息
      • 一段时间焊接统计数据汇总
      • 每日平焊长度
      • 每日平焊时长
      • 每日立焊长度
      • 每日立焊时长
      • 每日焊接长度
      • 每日焊接时长
      • 每日焊道数
      • 每日空闲时长
      • 每日加工时长 v2
    • 任务管理
      • 上传焊接任务
  • 付费功能配置接口
    • 配置加工完成回调
      POST
  1. 机床管理

机床状态变更记录

POST
https://mcs-gateway.fscut.com/api/user_devices/time_periods
机床管理
最后修改时间:2024-10-09 01:56:49

功能介绍#

用于查询认证机床在指定时间段内的状态变更记录

注意事项#

cardId ① 需要为认证机床的控制卡ID;② 需要为用户设备配额内的控制卡ID
startTime 和endTime相差不能超过一天且必须在同一天内
仅保存机床近100天的记录

请求参数

Header 参数
app-id
string 
必需
示例值:
op188b25734a433a79
time-stamp
string 
必需
示例值:
1701055999133
app-sign
string 
必需
示例值:
6829d50c9e68138b109d5ae040d48166
zoneId
string 
可选
可选,可以通过指定时区ID,指定查询的时区。不指定时默认查询时区为 Asia/Shanghai;
时区 ID 需要来自 IANA 时区数据库(TZDB)。无法识别的时区将被转化为 Asia/Shanghai;
示例值:
America/Chicago
Body 参数application/json
cardId
string 
控制卡ID
必需
startTime
string 
查询开始时间
必需
endTime
string 
查询截止时间
必需
示例
{
  "cardId": "1234567890",
  "startTime": "2023-11-17 00:00:00",
  "endTime": "2023-11-17 23:59:59"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://mcs-gateway.fscut.com/api/user_devices/time_periods' \
--header 'app-id: op188b25734a433a79' \
--header 'time-stamp: 1701055999133' \
--header 'app-sign: 6829d50c9e68138b109d5ae040d48166' \
--header 'zoneId: America/Chicago' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardId": "1234567890",
    "startTime": "2023-11-17 00:00:00",
    "endTime": "2023-11-17 23:59:59"
}'

返回响应

🟢200成功
application/json
Body
status
integer 
状态码
必需
msg
string 
响应信息
必需
data
array [object {4}] 
必需
time
integer 
必需
状态持续时间(单位:秒)
timeStart
string 
状态开始时间
必需
timeEnd
string 
状态结束时间
必需
status
string 
必需
机床状态;机床状态可能为:"OFFLINE"(离线)、"IDLE"(空闲)、"WORK"(加工)、"PAUSE"(暂停)、"ALARM"(报警)、"PLC"(PLC执行)、"UNKNOWN"(未知)
示例
{
  "status": 0,
  "msg": "OK",
  "data": [
    {
      "time": 21600,
      "timeStart": "2023-11-17 00:00:00",
      "timeEnd": "2023-11-17 06:00:00",
      "status": "OFFLINE"
    },
    {
      "time": 21600,
      "timeStart": "2023-11-17 06:00:00",
      "timeEnd": "2023-11-17 12:00:00",
      "status": "IDLE"
    },
    {
      "time": 21600,
      "timeStart": "2023-11-17 12:00:00",
      "timeEnd": "2023-11-17 18:00:00",
      "status": "WORK"
    },
    {
      "time": 3600,
      "timeStart": "2023-11-17 18:00:00",
      "timeEnd": "2023-11-17 19:00:00",
      "status": "PAUSE"
    },
    {
      "time": 3600,
      "timeStart": "2023-11-17 19:00:00",
      "timeEnd": "2023-11-17 20:00:00",
      "status": "ALARM"
    },
    {
      "time": 3600,
      "timeStart": "2023-11-17 20:00:00",
      "timeEnd": "2023-11-17 21:00:00",
      "status": "PLC"
    },
    {
      "time": 10799,
      "timeStart": "2023-11-17 21:00:00",
      "timeEnd": "2023-11-17 23:59:59",
      "status": "UNKNOW"
    }
  ]
}
上一页
机床详细信息
下一页
机床运行状态
Built with