用户信息同步
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>用户信息同步接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>index.php?r=consumerapi/userInfo</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
<li>form-data</li>
</ul>
<h5>请求方向</h5>
<ul>
<li>客户系统 → 大麦城</li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">kehuid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>客户ID</td>
</tr>
<tr>
<td style="text-align: left;">updatetype</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>更新方式，1新增，2编辑</td>
</tr>
<tr>
<td style="text-align: left;">usercode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户唯一标识</td>
</tr>
<tr>
<td style="text-align: left;">consumer_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>用户ID,编辑用户时，与usercode二选一</td>
</tr>
<tr>
<td style="text-align: left;">username</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>用户名</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>用户手机号码</td>
</tr>
<tr>
<td style="text-align: left;">integral</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>用户初始积分，仅新增用户时有效</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>状态，1启用，2停用，没有UserCode的用户强制为停用状态</td>
</tr>
<tr>
<td style="text-align: left;">userinfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>用户基本信息，JSON字符串，Base64加密</td>
</tr>
<tr>
<td style="text-align: left;">random_str</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>随机字符串</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>unix时间戳，有效期90秒</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名，参考：<a href="https://www.showdoc.com.cn/dmc/2665110292878346" title="签名生成">签名生成</a></td>
</tr>
</tbody>
</table>
<h5>userinfo参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>姓名</td>
</tr>
<tr>
<td style="text-align: left;">gender</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>性别，0男1女，默认0</td>
</tr>
<tr>
<td style="text-align: left;">user_type</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>会员类型，默认0，0个人，其余值待定</td>
</tr>
<tr>
<td style="text-align: left;">user_level</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>会员等级，对应后台添加的会员等级中的“星级”，请至后台中先行添加对应等级</td>
</tr>
<tr>
<td style="text-align: left;">email</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>电子邮箱地址</td>
</tr>
<tr>
<td style="text-align: left;">thumb</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>用户头像的图片地址</td>
</tr>
<tr>
<td style="text-align: left;">backup1</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备用字段1</td>
</tr>
<tr>
<td style="text-align: left;">backup2</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备用字段2</td>
</tr>
</tbody>
</table>
<h5>入参示例</h5>
<pre><code> {
"usercode":"USERCODE123",
"username":"testuser",
"mobile":"13800000001",
"integral":1000,
"status":1,
"userinfo":"eyJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjMsImFiYyI6MTIzLCJhYmMiOjEyMywiYWJjIjoxMjN9",
"random_str":"JEK2JK3989FK3JLFNM1122MN",
"timestamp":1660634288,
"sign":"F91DA38B458BA38BFA8A271A85AC60E1"
}</code></pre>
<h5>返回示例</h5>
<pre><code> {
"status":1,
"message":"保存成功",
"data":{
"consumer_id":45000
}
}</code></pre>
<h5>注意事项</h5>
<ul>
<li>编辑用户积分，请使用《<a href="https://www.showdoc.com.cn/dmc/9381634725039407" title="积分变更信息">用户积分变更</a>》接口。</li>
<li>编辑用户时，可使用consumer_id或usercode中的任意一项来辨别需要更新的用户，优先使用usercode。</li>
<li>用户信息userinfo请转为JSON格式字符串后，使用Base64加密。</li>
<li>用户等级的值，对应大麦城提供后台中，用户等级中填写的星级。可以按照米思米系统中会员等级的标识，在大麦城后台中添加对应的等级信息。只要保证接口参数中的用户等级在大麦城等级中有对应的星级即可。</li>
</ul>