# 注册接口使用说明

## 接口信息

- **URL**: `http://localhost:8080/api/admin/register`
- **方法**: `POST`
- **Content-Type**: `application/json`

## 使用方法

### 方法1：使用 Postman 或类似工具

1. 打开 Postman（或 Apifox、Insomnia 等）
2. 创建新请求：
   - **URL**: `http://localhost:8080/api/admin/register`
   - **方法**: `POST`
   - **Headers**: 
     ```
     Content-Type: application/json
     ```
3. **Body** (选择 raw + JSON):
   ```json
   {
     "username": "admin",
     "password": "123456",
     "nickname": "管理员"
   }
   ```
4. 点击发送

### 方法2：使用 curl 命令

在命令行执行：

```bash
curl -X POST http://localhost:8080/api/admin/register \
  -H "Content-Type: application/json" \
  -d "{\"username\":\"admin\",\"password\":\"123456\",\"nickname\":\"管理员\"}"
```

### 方法3：使用浏览器（需要安装插件）

安装 "REST Client" 或 "Talend API Tester" 浏览器插件

### 方法4：使用 PowerShell（Windows）

```powershell
$body = @{
    username = "admin"
    password = "123456"
    nickname = "管理员"
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:8080/api/admin/register" -Method Post -Body $body -ContentType "application/json"
```

## 请求示例

### 成功响应

```json
{
  "code": 200,
  "message": "注册成功",
  "data": "注册成功"
}
```

### 失败响应（用户名已存在）

```json
{
  "code": 500,
  "message": "用户名已存在",
  "data": null
}
```

## 完整示例

### 注册管理员账号

```json
POST http://localhost:8080/api/admin/register
Content-Type: application/json

{
  "username": "admin",
  "password": "123456",
  "nickname": "系统管理员",
  "phone": "13800138000",
  "email": "admin@example.com"
}
```

## 注意事项

1. **确保后端服务已启动**：服务运行在 `http://localhost:8080`
2. **密码会自动加密**：后端会自动将密码使用BCrypt加密存储
3. **自动设置为管理员**：注册的账号 `user_role` 会自动设置为 `1`（管理员）
4. **用户名不能重复**：如果用户名已存在，会返回错误

## 快速测试

最简单的测试方式：

1. 确保后端服务正在运行
2. 打开浏览器开发者工具（F12）
3. 在 Console 中执行：

```javascript
fetch('http://localhost:8080/api/admin/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    username: 'admin',
    password: '123456',
    nickname: '管理员'
  })
})
.then(res => res.json())
.then(data => console.log(data));
```