API Endpoints

Available API Endpoints

The ελββφν API offers a suite of endpoints to manage resources, users, and authentication. All endpoints follow RESTful conventions and return JSON-formatted responses.

Authentication
GET /auth/user

Retrieve Current User Info

  • • Requires Bearer Token Authentication
  • • Returns user's email, role, and active status
  • • 200 OK for success, 401 for unauthorized requests
POST /auth/login

User Login

  • • Accepts email and password in JSON body
  • • Returns JWT token and user ID
  • • 200 OK for success, 401 for invalid credentials
{
  "email": "user@example.com",
  "password": "securepassword123"
}

User Management
GET /users

List All Users

  • • Returns paginated array of user records
  • • Requires Admin access
  • • Supports query parameters for filtering by role
POST /users

Create New User

  • • Creates user with email, password, and role
  • • Returns 201 Created with user ID
  • • 422 Unprocessable Entity for validation errors

File Operations
GET /files

List Uploaded Files

  • • Returns file metadata (name, size, upload date)
  • • Supports sorting by most recent or size
  • • Requires valid Bearer Token
POST /files/upload

Upload New File

  • • Accepts multipart/form-data with file
  • • Returns unique file ID and upload status
  • • Max file size: 100MB