1 背景介绍
商米数字店铺(SUNMI Store)是商米提供的基于店铺物联网设备的店铺管理系统。
商米数字店铺作为一个开放平台,支持与第三方软件进行各种对接,包括设备层面智能摄像机、电子价签的对接,数据层面的商品信息、交易信息对接等。
如果客户想要在第三方软件上进行价签设备的管理,包括价签与商品的绑定,指定价签闪灯等,可以通过对接将相应功能集成到第三方软件中。
下文列出的就是全面对接价签系统管理功能的相关接口。
2 接口规范
2.1 协议说明
对接的openAPI接口目前只开放HTTPS方式,所有的消息一律采用POST方式。
注:消息体大小不得超过1M,超过1M的请求,直接拒绝!
Content-Type | application/x-www-form-urlencoded |
---|---|
数据格式 | 返回为JSON格式 |
字符编码 | UTF-8字符编码 |
签名算法 | MD5 |
签名规则 | 参考下文签名规则 |
2.2 签名规则
参考鉴权认证
2.3 公共参数
参数名 | 必填 | 类型 | 说明 |
---|---|---|---|
app_id | 是 | string | 唯一标识接入身份,联系商米数字店铺提供 |
random | 是 | string | 随机字符串,由数字和字母组成,长度范围为6-10位 |
timestamp | 是 | int | 当前的unix timestamp,精度到秒级,10位数字 |
sign | 是 | string | 签名信息,详见签名规则 |