用户

# 用户注册(通过开票助手用户id) 为了安全起见,该接口只允许服务端调用,由第三方服务端发起注册请求,签名参数中无需传入userId或userNo。 请求路径: `/openapi/user/register` 请求方法: ` POST` 接口参数: |字段名|类型|必填|说明| | ----- | ------- | ------- |-------- | |userNo|String|是|开票助手用户id。长度10~50的数字、字母或下划线| 请求参数示例: ```json { "userNo":"asoiUTudzxn384AED023ase12Afds8q2" } ``` 响应结果: | 字段名 | 类型 | 说明 | | ------------ | ------------ | ------------ | | code | Integer | 处理结果 | | message | String | 结果描述 | | data | Object | 用户信息(UserDTO) | UserDTO: | 字段名 | 类型 | 说明 | | ------------ | ------------ | ------------ | | userId | Long | 开票助手用户id| 响应结果示例: ```json 失败: { "code": -1, "message": "userNo格式不正确" } { "code": 1001, "message": "userNo已存在" } 成功: { "code": 0, "data": { "userId":32142341423432532 } } ``` # 用户注册(通过手机号) * 客户端和服务端认证方式无需传入userId或userNo 请求路径: `/openapi/user/register2` 请求方法: ` POST` 接口参数: |字段名|类型|必填|说明| | ----- | ------- | ------- |-------- | |phone|String|是|手机号| |password|String|是|密码| 请求参数示例: ```json { "phone":"13599462839", "password":"123456" } ``` 响应结果: | 字段名 | 类型 | 说明 | | ------------ | ------------ | ------------ | | code | Integer | 处理结果 | | message | String | 结果描述 | | data | Object | 用户信息(UserDTO) | UserDTO: | 字段名 | 类型 | 说明 | | ------------ | ------------ | ------------ | | userId | Long | 开票助手用户id| 响应结果示例: ```json 失败: { "code": -1, "message": "手机号格式不合法 } { "code": 1000, "message": "该手机号已被注册" } 成功: { "code": 0, "data": { "userId":32142341423432532 } } ``` # 给当前用户添加子用户 该接口只允许服务端调用,由第三方服务端发起注册请求,签名中需要传入userId或userNo用于标识主账号。 请求路径: `/openapi/user/addSubUser` 请求方法: ` POST` 接口参数: |字段名|类型|必填|说明| | ----- | ------- | ------- |-------- | |storeIds|Long[]|否|开票助手门店id(用于限定子用户的权限范围)| |storeNos|Long[]|否|第三方门店id(用于限定子用户的权限范围)| |subUserNo|String|是|子用户唯一标识| 请求参数示例: ```json { "storeIds":[1], "subUserNo":"oesdbf823bl827AGOUw278312" } ``` 响应结果: | 字段名 | 类型 | 说明 | | ------------ | ------------ | ------------ | | code | Integer | 处理结果 | | message | String | 结果描述 | | data | Object | 用户信息(UserDTO) | UserDTO: | 字段名 | 类型 | 说明 | | ------------ | ------------ | ------------ | | userId | Long | 用户在该合作伙伴下的ID,在同一个APPID下唯一| 响应结果示例: ```json 失败: { "code": 1002, "message": "userNo已存在" } { "code": 4002, "message": "xxx门店不存在" } 成功: { "code": 0, "data": { "userId": 72057594040137733 } } ```