5zu-xiaocx/注册接口使用说明.md

注册接口使用说明

接口信息

• 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):

   {
    "username": "admin",
    "password": "123456",
    "nickname": "管理员"
   }
   

4. 点击发送

方法2：使用 curl 命令

在命令行执行：

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）

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

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

请求示例

成功响应

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

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

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

完整示例

注册管理员账号

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 中执行：

   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));