Elite Events API Documentation

Overview

Elite Events provides a comprehensive REST API for e-commerce operations including products, orders, promotions, loyalty programs, support, and admin functionality.

Base URLs

Authentication

Session-Based (Web)

Most endpoints use NextAuth session cookies for authentication. Sessions are automatically managed via HTTP-only cookies.

Bearer Token (API)

For programmatic access, include the session token in the Authorization header:

Authorization: Bearer <session-token>

Public Endpoints

Some endpoints are publicly accessible without authentication:

• GET /api/products - List products
• GET /api/products/[slug] - Get product details
• GET /api/categories - List categories
• POST /api/auth/* - Authentication endpoints

Response Format

Success Response

{
  "success": true,
  "data": { ... },
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 100,
      "totalPages": 5,
      "hasMore": true
    }
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid email address",
    "details": [
      { "field": "email", "message": "Must be a valid email" }
    ]
  }
}

Rate Limits

Rate limit headers are included in responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1609459200

HTTP Status Codes

Common Query Parameters

Pagination

?page=1&limit=20

Sorting

?sortBy=createdAt&sortOrder=desc

Filtering

?categoryId=1&minPrice=10&maxPrice=100

Search

?search=keyword

API Endpoints

Public Endpoints

Authentication

User Endpoints (Authenticated)

Cart & Wishlist

Orders

Payments

Promotions

Loyalty

Support

Admin Endpoints

See Admin API for full documentation.

Monitoring

Detailed Documentation

• Products API
• Orders API
• Users API
• Promotions API
• Admin API

OpenAPI Specification

Interactive API documentation is available at:

• Production: https://elite-events.dcsuniverse.com/docs
• Development: http://localhost:3000/docs

Error Codes

Webhooks

Elite Events can send webhooks for various events:

Configure webhooks in Admin > Settings > Webhooks.

SDKs & Examples

JavaScript/TypeScript

// Using fetch
const response = await fetch('/api/products?limit=10', {
  headers: {
    'Content-Type': 'application/json',
  },
});
const { data, meta } = await response.json();

cURL

curl -X GET "https://elite-events.dcsuniverse.com/api/products?limit=10" \
  -H "Content-Type: application/json"

Support

For API support, contact:

• Email: support@dcsuniverse.com
• Documentation: https://elite-events.dcsuniverse.com/docs