94 lines
1.8 KiB
Markdown
94 lines
1.8 KiB
Markdown
|
# APP登录注册二合一接口文档
|
|||
|
|
|
|||
|
|
## 登录注册二合一
|
|||
|
|
|
|||
|
|
**接口地址：** `POST /app/loginOrRegister`
|
|||
|
|
|
|||
|
|
**接口说明：** 根据手机号查询用户，存在则登录，不存在则注册后登录
|
|||
|
|
|
|||
|
|
**请求参数（Body JSON）：**
|
|||
|
|
|
|||
|
|
| 参数名 | 类型 | 必填 | 说明 |
|
|||
|
|
|--------|------|------|------|
|
|||
|
|
| username | String | 是 | 手机号码 |
|
|||
|
|
| name | String | 是 | 姓名 |
|
|||
|
|
| idCard | String | 否 | 身份证号 |
|
|||
|
|
|
|||
|
|
**请求示例：**
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"username": "13800138000",
|
|||
|
|
"name": "张三",
|
|||
|
|
"idCard": "110101199001011234"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**响应参数：**
|
|||
|
|
|
|||
|
|
| 参数名 | 类型 | 说明 |
|
|||
|
|
|--------|------|------|
|
|||
|
|
| code | Number | 状态码，200 表示成功 |
|
|||
|
|
| msg | String | 提示信息 |
|
|||
|
|
| token | String | 登录令牌 |
|
|||
|
|
| isNewUser | Boolean | 是否新用户（true=新注册，false=已存在） |
|
|||
|
|
| idCard | String | 身份证号 |
|
|||
|
|
|
|||
|
|
**响应示例（新用户注册）：**
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"msg": "操作成功",
|
|||
|
|
"token": "eyJhbGciOiJIUzUxMiJ9...",
|
|||
|
|
"isNewUser": true,
|
|||
|
|
"idCard": "110101199001011234"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**响应示例（老用户登录）：**
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"msg": "操作成功",
|
|||
|
|
"token": "eyJhbGciOiJIUzUxMiJ9...",
|
|||
|
|
"isNewUser": false,
|
|||
|
|
"idCard": "110101199001011234"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**错误响应示例：**
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 500,
|
|||
|
|
"msg": "电话号码不能为空!"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 500,
|
|||
|
|
"msg": "姓名不能为空!"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**cURL 测试示例：**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X POST http://localhost:8080/app/loginOrRegister \
|
|||
|
|
-H "Content-Type: application/json" \
|
|||
|
|
-d '{"username":"13800138000","name":"张三","idCard":"110101199001011234"}'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
不带身份证：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X POST http://localhost:8080/app/loginOrRegister \
|
|||
|
|
-H "Content-Type: application/json" \
|
|||
|
|
-d '{"username":"13800138000","name":"张三"}'
|
|||
|
|
```
|