云打印机CP事件及消息示例

1 事件列表

event取值说明
6001未经处理的文字小票上传消息
6002未经处理的图片小票上传消息
6003经过处理的小票消息

2 事件消息示例

2.1 未经处理的文字小票上传消息(event=6001)

{
  "id": 123,     // 系统生成的小票ID
  "sn": "sn",    // 打印设备SN
  "text": "abc"  // 文字小票内容
}

2.2 未经处理的图片小票上传消息 (event=6002)

{
  "id": 123,  // 系统生成的小票ID
  "sn": "sn", // 打印设备SN
  "base64_image": "avc"  // 图片小票的base64 encoded string
}

2.3 经过处理的小票消息 (event=6003)

{
  "id": 123,  // 系统生成的小票ID
  "sn": "sn",  // 打印设备SN
  "order_id": 456, // 小票上的订单ID
  "order_time": "2020-01-01", // 小票生成时间
  "total_payment": 10.11  // 小票金额
  "sales_detail_list": [{   //明细列表
    "amount": 10,          // 商品单价
    "item":   "商品",      // 商品名字
    "quantity": 1          // 商品数量
  },
  ...
  ]
}

智能摄像机IPC事件及消息示例

1 事件列表

event 取值说明
1010IPC FM010 动态侦测消息
1011 IPC上线消息通知
1012 IPC下线消息通知
1100向指定人脸分组添加人脸信息的结果推送消息
1101客户定制事件(LK)- (不对外公开)
2001IPC实时获取人员消息

2 事件消息示例

2.1 IPC FM010 动态侦测消息 (event=1010)

消息payload

{
    "ipc_id": 029388,
    "sn": "FS101D8BS00080",
    "name": "设备1",
    "video_url": "http://xxx.xxx.xxx.xxx/xxx/xxx/41b061f6f10dbd6fe1aaf469fb0ab012d9193d9655816af31cdfbcsdfe71a5fe1",
    "model_name": "FM020",
    "motion_type": 1
}

字段描述:motion_type

motion_type取值说明
1视频侦测事件
2声音侦测事件

2.2 IPC上线消息通知 (event=1011)

消息payload

{
    "ipc_id": "549755811676",
    "ipc_name": "摄像头设备1",
    "ipc_sn": "FS101D8BS00080",
    "online_time": 1576415912
}

2.3 IPC下线消息通知 (event=1012)

消息payload

{
    "ipc_id": "549755811676",
    "ipc_name": "摄像头设备1",
    "ipc_sn": "FS101D8BS00080",
    "offline_time": 1576415912
}

2.4 向指定人脸分组添加人脸信息的结果推送消息 (event=1100)

消息payload

{
    "code": 0,                 /*其他错误参考下方字段描述 */
    "msg": "", 
    "face_id": "235698745612",
}

字段描述

code说明
5527不合格的人脸照片
5000数据库错误

2.5 IPC实时获取人员消息 (event=2001)

消息payload

{
    "ipc_id": "512369745691",
    "ipc_sn": "FS101D8BS00080",
    "face_id": "235698745612",
    "face_image_url": "https://xxxxxx/IMG/FACE/NKO62XI9PJ4MJX9HJNZ0VOTX863LKBV0?auth_key=1585224994-EULH8E2CXI-0-8ba0ee794d1f4a08c9134898d3013938",   //有效期为一天
    "gender": 1,
    "age_range": 4,
    "group_id": "8927",
    "group_name": "stranger",
    "group_type": 2,
    "member_id": "2938203938",  //如果获取的人员为录入会员,则返回会员id,非会员,则返回为""
}

字段描述

gender 取值说明
0未知
1
2
age_range 取值说明
10~6岁
27~12岁
313~18岁
419~28岁
529~35岁
636~45岁
746~55岁
856~ 岁
group_type 取值说明
1生客人脸库
2熟客人脸库
3店员人脸库
5自定义人脸库

附录

更新记录

更新日期更新内容
2020-04-10 payload(event=2001),返回值增加ipc_sn字段

电子价签ESL事件及消息示例

1 事件列表

event 取值说明
4011基站上线消息通知 (暂未开放)
4012基站下线消息通知 (暂未开放)
4100 商品变价通知消息(暂未开放)
4200价签推图状态消息通知
4300基站状态信息定时推送(商户级别 1分钟一次,一页最多100条)
4400价签状态信息定时推送 (商户级别 20分钟一次,一页最多100条)

2 事件消息示例

2.1 价签推图状态消息通知 (event=4200)

消息 payload

{
    "esl_code": "DISLDDMK",
    "result": 1,
    "product_name": "Fish",
    "product_seq_num": "282937287",
    "template_name": "2.13-BW",
    "source": 1,
    "trace_id":  "2938329018273" (可选,如果没有指定,则为"" )
}

字段描述:result

result 取值说明
0事件开始
1成功
2失败

字段描述:source

source取值说明
1 (暂未开放) 商品更新
2绑定商品
3 (暂未开放) 解绑商品
4 (暂未开放) 价签重推
5 (暂未开放) 模板更新

2.2 基站状态信息定时推送 (event=4300)

商户级别,定时推送基站状态信息,每分钟一次推送,推送内容详见如下实例中的payload字段

报文格式: application/x-www-form-urlencoded;param=value;charset=UTF-8

消息体格式:
{ 
  "app_id": 'DT8A77EAD0966',                //唯一标识接入身份,联系商米数字店铺提供
  "event": '4300',                          // 触发消息的类型
  "payload":'{
      "ap_list:[
          {
              "ap_id":"514157283292",      //基站商米ID
              "ap_sn":"APSN01",            //基站序列号
              "ap_mac":"0C25765D9414",     //基站mac地址
              "status":2,                  //基站状态
              "shop_id":""                 //基站所属推送方店铺id, 没有或没有推送方店铺映射者,则为空
          },
          {
               "ap_id":"514157283291",
               "ap_sn":"APSN02",
               "ap_mac":" ",
               "status":2,
               "shop_id":"30316"
           }
      ]
  }',
  random: 'JFMTSU',                           // 随机字符串,由数字和字母组成,长度范围为6-10位
  shop_id: '',                                // 店铺在SaaS软件体系下的唯一标识, 没有或者不需要则为空
  sign: '048C4C4C215531E856FF957E69EBDFCF',   //签名校验
  sunmi_shop_no: '',                          // 商米数字店铺平台门店唯一编号, 没有或者不需要则为空
  timestamp: '1605149745'                     //当前的unix timestamp,精度到秒级,10位数字
}

备注:payload字段对应的值为string类型,解析对此string类型内容进行json解析

字段描述:status

status取值说明
0未注册
1在线
2离线

2.3 基站状态信息定时推送 (event=4400)

商户级别,定时推送价签状态信息,每20分钟一次推送,推送内容详见如下实例中的payload字段

报文格式: application/x-www-form-urlencoded;param=value;charset=UTF-8

消息体格式:
{ 
  "app_id": 'DT8A77EAD0966',                //唯一标识接入身份,联系商米数字店铺提供
  "event": '4400',                          // 触发消息的类型
  "payload":'{
      "esl_list:[
          {
              "esl_id":"514157164491",    //价签id
              "esl_sn":"B101203J00156",   //价签sn
              "esl_mac":"0C25768271CA",   //价签mac地址
              "online_status":0,          //价签在线状态
              "shop_id":"",               //价签所属推送方店铺id, 没有或没有推送方店铺映射者,则为空
              "esl_code":"RN1C41PD",      //价签code
              "screen_size":"2.13寸",     //价签尺寸
              "battery":21,               //价签电量
              "rssi":-55                  //价签信号
          },
          {
              "esl_id":"514157160628",
              "esl_sn":"B101203J00139",
              "esl_mac":"0C25768271AA",
              "online_status":0,
              "shop_id":"30316",
              "esl_code":"RN1C41PS",
              "screen_size":"2.13寸",
              "battery":13,
              "rssi":-51
           }
      ]
  }',
  random: 'JFMTSU',                           // 随机字符串,由数字和字母组成,长度范围为6-10位
  shop_id: '',                                // 店铺在SaaS软件体系下的唯一标识, 没有或者不需要则为空
  sign: '048C4C4C215531E856FF957E69EBDFCF',   //签名校验
  sunmi_shop_no: '',                          // 商米数字店铺平台门店唯一编号, 没有或者不需要则为空
  timestamp: '1605149745'                     //当前的unix timestamp,精度到秒级,10位数字
}

备注:payload字段对应的值为string类型,解析对此string类型内容进行json解析
online_status 取值说明
0离线
1在线

消息中心

1 基本描述

商米数字店铺开放平台与SaaS合作方的数据交互可以是双向实时。一方面SaaS合作方可以将数据通过openAPI传入数字店铺,也可以对商米的IoT设备进行远程控制。

除此之外,商米数字店铺开放平台也可以通过消息推送中心,将系统中的消息实时反馈给SaaS合作方。根据合作平台需求订阅实时消息推送,商米数字店铺开放平台会将消息和事件推送给SaaS合作方。

2 接口规范

2.1 协议说明

对接的接口目前只开放HTTPS方式推送消息,所有的消息一律采用POST方式。

Content-Typeapplication/x-www-form-urlencoded
数据格式返回为JSON格式
字符编码UTF-8字符编码
签名算法MD5
签名规则参考2.2 签名规则

2.2 签名规则

参考《鉴权认证》文档。

2.3 公共参数

参数名必填类型说明
app_idstring唯一标识接入身份,联系商米数字店铺提供
randomstring随机字符串,由数字和字母组成,长度范围为6-10位
timestampint当前的unix timestamp,精度到秒级,10位数字
signstring签名信息,详见2.2

3 店铺设计规范

参考《商户店铺》文档。

4 SaaS合作方提供HTTP回调地址

SaaS合作方添加监听事件时,需要提供相应的HTTP回调地址,并提供需要监听的设备以及事件。当商米数字开放平台收到该设备的该事件时,会调用该HTTP接口。

4.1 回调HTTP鉴权方式

对于该回调HTTP回调的鉴权方式,遵照商米数字店铺开放平台的鉴权方式。 请参考《鉴权认证》文档。

4.2 回调HTTP接口参数

回调HTTP需要带以下接口参数:

参数名称是否必须类型说明
sunmi_shop_nostring 商米数字店铺平台门店唯一编号
shop_idstring 店铺在SaaS软件体系下的唯一标识
eventint触发消息的类型
payloadstring消息的具体格式(根据消息不同会有不同的json)

消息的具体格式请参考相关业务的《事件及消息示例》文档。

4.3 消息重传

如果回调消息发送失败,会触发重传机制。一共会触发4次重传,时间间隔分别为15秒, 30 秒, 1分钟和2分钟。

5 消息监听接口

5.1 接口描述

消息监听接口用来管理需要监听的事件和相应的回调HTTP地址。

5.2 接口列表

接口名称接口描述
/hook/add增加消息监听的HTTP回调地址
/hook/delete取消消息监听的HTTP回调地址

5.3 接口详情

5.3.1 增加消息监听

接口描述:通过本接口调用,用户可以增加消息监听的HTTP回调地址。

请求链接:/hook/add

接口版本: v2.0

接口参数

参数名称是否必须类型说明
sunmi_shop_no string 商米数字店铺平台门店唯一编号(v2.0之后为必填项)
shop_idstring店铺在SaaS软件体系下的唯一标识(此参数为后向兼容v2.0之前版本的字段,在v2.0及以后版本使用sunmi_shop_no替代,作为门店唯一标识即可)
http_callbackstringHTTPS回调地址链接
event_listarray[int]需要监听的事件的列表

返回值: 

{
    "code": 0,   /* 其他错误参考错误列表 */
    "msg": "succeed",
    "data": {}
}

5.3.2 取消消息监听

接口描述:通过本接口调用,用户可以取消消息监听的HTTP回调地址。

请求链接:/hook/delete

接口版本: v2.0

接口参数

参数名称是否必须类型说明
sunmi_shop_no string商米数字店铺平台门店唯一编号(v2.0之后为必填项)
shop_idstring店铺在SaaS软件体系下的唯一标识(此参数为后向兼容v2.0之前版本的字段,在v2.0及以后版本使用sunmi_shop_no替代,作为门店唯一标识即可)
event_listarray[int]需要取消监听的事件的列表

返回值: 

{
    "code": 0,   /* 其他错误参考错误列表 */
    "msg": "succeed",
    "data": {}
}