Ezeniia API

API Overview

Introduction

Ezeniia's RESTful API enables programmatic access to our platform's core functionality. With robust authentication, comprehensive endpoints, and versioning support, developers can seamlessly integrate with our ecosystem.

Base URL

https://api.ezeniia.com/v2

Environment

Authentication

All endpoints require API keys with appropriate permissions

GET /users
curl -H "Authorization: Bearer $API_KEY" \
  "https://api.ezeniia.com/v2/users"
View Auth Details

Versioning

All APIs follow semantic versioning

Current API Version: 2.1.3

Release Date: April 15, 2025 Changelog

We recommend upgrading to v2.1.3 for improved performance and security. The v2.1.2 will be deprecated on December 31, 2025.

View Release Notes

API Endpoints

Core Resources

GET
/v2/users

Retrieve user information

Query Parameters:
userId: string status: string
200 OK 
{
  "id": "user-12345",
  "email": "admin@example.com",
  "created_at": "2025-04-15T10:30:00Z"
}
POST
/v2/users

Create a new user account

Body:
email: string password: string
201 Created 
{
  "id": "user-67890",
  "message": "User created successfully"
}

Authentication

API Key Authentication

Use your personal API key to authenticate all requests.
curl -H "Authorization: Bearer YOUR_API_KEY"
  "https://api.ezeniia.com/v2/users"

Need an API Key?

Create one in the Developer Console to access all API endpoints.

Open Console

OAuth 2.0 Authentication

For third-party applications using client credentials grant flow.
POST /oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
OAuth2 Guide Token Tool

API Examples

User Management Example

Create User

Request Example
POST /v2/users
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "email": "newuser@example.com",
  "password": "securePassword123"
}

Response 201:

{ "id": "user-987654", "message": "User created successfully" }

Get User Details

Request Example
GET /v2/users/user-987654
Authorization: Bearer YOUR_API_KEY

Response 200:

{ "user_id": "user-987654", "email": "newuser@example.com", "status": "active" }

Data Management Example

Create Data

Request Example
POST /v2/data/users
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "user_id": "user-987654",
  "preferences": {
    "theme": "dark",
    "language": "en"
  }
}

Response 201:

{ "id": "data-321", "created_at": "2025-04-20T10:30:00Z" }

Get Data

Request Example
GET /v2/data/users/user-987654
Authorization: Bearer YOUR_API_KEY

Response 200:

{ "user_id": "user-987654", "preferences": { "theme": "dark", "language": "en" } }