用户
# 用户注册(通过开票助手用户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
}
}
```