Eseniiiii v

Welcome to the Eseniiiiav API

Access, manipulate and extend capabilities with our modern API architecture

API Base URL

https://api.eseniiiiav.com/v2

All endpoints follow RESTful conventions and return JSON-formatted responses. Rate limits apply starting at 1200 requests/minute.

Endpoints

Resource: /users

GET
/users
PUBLIC

Get Users

Retrieves a list of all active users

Query Parameters
page
Current page number
limit
Number of users per page (max 100)
Example Response
200 OK
{
  "users": [
    {
      "_id": "5f1b1a8b9c9d840000ea6e71",
      "username": "johndoe",
      "email": "john@example.com",
      "lastActive": "2025-01-15T08:32:17Z"
    }
  ],
  "meta": {
    "total": 450,
    "page": 1,
    "limit": 50
  }
}
POST
/users

Create User

Registers a new user account

Required Body
username

Unique username (6-20 characters)

email

Valid email address

password

Secure password (8+ chars)

Example Response
201 Created
{
  "userId": "607a2d579c84140018d33a12",
  "username": "janedoe",
  "email": "jane@example.com",
  "created": "2025-09-20T07:45:33Z",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Authentication

API Keys

Use bearer authentication tokens to access protected endpoints. Tokens expire after 24 hours by default, but can be refreshed.

How to Authenticate

Example
curl -H "Authorization: Bearer YOUR_API_KEY" \\ -X GET https://api.eseniiiiav.com/v2/users

Getting Started

  1. Visit the API Keys section in your dashboard
  2. Generate a new key with appropriate permissions
  3. Store the key securely in your application's environment or key vault
  4. Include it in the Authorization header for each request

Examples

Get User Profile

GET /api/v2/users/12345
curl 'https://api.eseniiiiav.com/v2/users/12345' \\ -H 'Authorization: Bearer YOUR_API_KEY'
{ "user": { "id": "12345", "name": "Jane Smith", "email": "jane.smith@example.com", "roles": ["admin", "developer"], "last_login": "2025-09-18T14:32:56Z" } }