指令状态变更通知集成接口

POST /spi/cmd/notif

提供者: Micro-GNSS

调用者: 企业应用

企业应用在Micro-GNSS请求的指令的状态发生变更时（如指令下发完成时、指令被应答时、或下发指令出错时，或指令被取消时，或指令超时时），调用本接口通知Micro-GNSS服务。

请求

POST /spi/cmd/notif
Content-Type: application/json

{
    "id": "433350002",
    "reqTm": 1643006473800,
    "status": 2,
    "tm": 1643006473802,
    "initMsgId": "8201",
    "simNo": "13320200317",
    "ackMsgId": "0201",
    "ackSeqNo": 3,
    "ackParams": {
        "trk": {
            "simNo": "13320200317",
            "recvTm": 1643006473802,
            "gpsTm": 1643006473000,
            "alm": 0,
            "st": 524291,
            "lng": 121.42949,
            "lat": 31.24088,
            "alt": 10,
            "spd": 30.0,
            "recSpd": 30.0,
            "dir": 0
        }
    }
}

请求实体属性

属性	数据类型	必要	说明
id	string	Y	终端指令记录ID。此ID与调用下发指令 POST /term_cmd 接口返回的id一致。指出本通知所指代的指令记录
reqTm	string	Y	指令的请求时间，格式：yyyy-MM-dd HH:mm:ss。（对应 TermCmd中的reqTm属性）
status	int	Y	指令的新的状态： 1: 已下发 2：终端已应答 -1：执行异常 -2：指令格式不正确,无效格式，服务器无法下发 -3：指令不支持 -4: 用户取消 -5: 终端不在线 -6: 超时 （对应 TermCmd中的status属性）
tm	string	Y	指令状态的变更时间，格式：yyyy-MM-dd HH:mm:ss
initMsgId	string	Y	下发指令时指令的消息号（对应 TermCmd中的msgId属性）
subCmdTyp	string		下发指令时指令的子命令类型（对应 TermCmd中的subCmdTyp属性）
msgSn	int		下发指令时的消息流水号（对应 TermCmd中的msgSn属性）
simNo	string	Y	下发指令时指令的终端识别号（对应 TermCmd中的simNo属性）
ackMsgId	string		终端应答的指令消息号，JT/T 808，JT/T 1078 指令消息号。仅当status == 2时有效
ackSeqNo	int		终端应答的指令消息流水号。仅当status == 2时有效
ackCode	int		终端应答的应答码。仅当status == 2且应答消息有应答码时有效。具体参见 终端指令集成接口参数、应答通知 中各指令说明
ackParams	object		终端应答的数据内容。仅当status == 2且应答消息有应答内容时有效。具体参见 终端指令集成接口参数、应答通知 中各指令说明

应答

{
  "errCode": 0,
  "message": "成功。"
}