API Reference

Complete REST API documentation for KmerHosting services

Base URL

Authentication

Most endpoints require authentication via session cookies (NextAuth). After logging in, the session is maintained automatically.

// Login request
POST /api/user/auth/login
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "YourSecurePassword123!"
}

// Response
{
  "success": true,
  "data": {
    "user": {
      "id": "uuid",
      "email": "[email protected]",
      "customerId": "KH-XXXXXX"
    }
  }
}

Response Format

{
  "success": true,
  "data": {
    // Response data here
  }
}

{
  "success": false,
  "error": "Error message description"
}

HTTP Status Codes

API Endpoints

Rate Limiting

To ensure fair usage, our API implements rate limiting on authentication endpoints:

• Login: 5 attempts per 15 minutes per IP
• Registration: 3 attempts per hour per IP
• Password Reset: 3 attempts per hour per IP