Skip to main content

Authentication API

PveSphere API uses JWT (JSON Web Token) for authentication.

User Login​

Request​

POST /api/v1/user/login
Content-Type: application/json

Request Body​

{
  "email": "pvesphere@gmail.com",
  "password": "Ab123456"
}

Response​

{
  "code": 200,
  "message": "success",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user": {
      "id": 1,
      "email": "pvesphere@gmail.com",
      "nickname": "PveSphere Admin"
    }
  }
}

Refresh Token​

Request​

POST /api/v1/user/refresh
Authorization: Bearer <token>

Response​

{
  "code": 200,
  "message": "success",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

User Logout​

Request​

POST /api/v1/user/logout
Authorization: Bearer <token>

Response​

{
  "code": 200,
  "message": "success"
}

Using Token​

In subsequent requests, you need to include the Token in the request header:

Authorization: Bearer <your-token>