Elegia API Reference

Authentication

All API requests require an authentication key. You can find your API key in your developer dashboard.

Bearer Authentication


// Set API key as bearer token
Authorization: Bearer <YOUR_API_KEY>

OAuth 2.0


POST /auth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "your-client-id",
  "client_secret": "your-client-secret"
}

API Endpoints

/api/v1/users

Manage user accounts and profiles

GET /api/v1/users

Retrieve list of users


GET /api/v1/users
Authorization: Bearer <YOUR_API_KEY>

POST /api/v1/users

Create new user


POST /api/v1/users
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "name": "Jane Doe",
  "email": "jane@example.com"
}

/api/v1/data

Access and store user-generated content

GET /api/v1/data

Query data


GET /api/v1/data
Authorization: Bearer <YOUR_API_KEY>

POST /api/v1/data

Submit new data


POST /api/v1/data
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "key": "value",
  "metadata": {
    "author": "jane_doe"
  }
}

Rate Limiting

Free Plan

• 1000 requests/minute
• 3000 total requests/day
• No data retention guarantees
• 24/7 availability SLA

Premium Plan

• 5000 requests/minute
• 120000 total requests/day
• 99.9% SLA
• Dedicated support
• Data retention up to 180 days

Need more than the premium tier? Contact enterprise.

Usage Examples

JavaScript SDK


import Elegia from 'elegia-sdk';

const client = new Elegia({
  apiKey: 'your_api_key',
  environment: 'prod'
});

async function getUsers() {
  try {
    const response = await client.get('/api/v1/users', {
      limit: 20,
      sort: 'created_at'
    });

    console.log('Users:', response.data);
  } catch (error) {
    console.error('API Error:', error);
  }
}

getUsers();

CLI / cURL

Search Users


curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -X GET "https://api.elegia.com/v1/users?search=janedoe"