API Documentation

Access programmatic control of Eseniiiav features through our RESTful API endpoints and SDKs.

1. Authentication

API Key Setup

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Generate or find your API key in the account settings section of your dashboard.

2. API Endpoints

GET /components List Components

Retrieve a list of all available components in your project.

Query Parameters

type

Filter by component type

page

Pagination page number

Example Request


cURL: curl 'https://api.eseniiiav.com/components?type=button' \n
      -H 'Authorization: Bearer YOUR_API_KEY'

Response

{\n  "components": [\n    {\n      "id": "BTN-001",\n      "name": "Primary Button",\n      "type": "button",\n      "created_at": "2024-03-15T10:30:00Z"\n    }\n  ],\n  "page": 1,\n  "total": 42\n}

POST /components Create Component

Create a new custom component for your project.

Required JSON Body


{
  "name": "Custom Button",
  "type": "button",
  "metadata": {
    "style": "font-weight: bold;",
    "variants": ["primary", "outline"]
  }
}

Example Response


{
  "id": "BTN-042",
  "name": "Custom Button",
  "type": "button",
  "created_at": "2024-09-25T14:15:00Z",
  "success": true
}

3. Error Handling

401 Unauthorized

Missing or invalid API key in Authorization header.

400 Invalid Request

Required fields missing or incorrect payload format.

429 Rate Limited

Maximum request rate exceeded. Please retry after 15 minutes.

4. SDK Integration

JavaScript SDK


// Initialize client\nconst client = new EseniiiavClient({\n  apiKey: 'YOUR_API_KEY'\n});\n\n// Get components\nclient.getComponents().then(components => {\n  console.log(components);\n});

Python SDK


from eseniiiav import Client\n\nclient = Client(api_key="YOUR_API_KEY")\ncomponents = client.get_components()\nprint(components)