用户接口

[toc]

1 概要

1.1 简介

商米数字店铺(SUNMI Store)是商米提供的围绕商户店铺中物联网设备基础上的店铺管理系统。但首先需要用户注册,成为商米合法用户,才能创建商户、店铺。然后用户可以登录商米数字店铺的web页面,或者商米助手等去查看,操作自己的门店下面的设备及数据。

2 接口规范

2.1 协议说明

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

注:消息体大小不得超过1M,超过1M的请求,直接拒绝!

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

2.2 签名规则

参考《鉴权认证》文档。

2.3 公共参数

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

3 开放API接口

3.1 用户注册

接口描述:通过本接口调用,实现商米数字平台用户注册。

请求链接:/user/register

接口版本:v1.0.0

接口参数

参数名称 是否必须 类型 说明 示例
usernamestring商米数字平台商户管理员账户,目前仅支持手机号码。13216886688
country_codeint注册区域:1-国内 2-国外。默认11

返回值: 

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

错误码:

错误码说明
204手机号码已经存在