API Overview

The NeXuS API Gateway runs on port 4000 and serves as the central REST API for the platform. It provides Docker container statistics, health monitoring, Cloudflare DNS management, and system overview data.

Base URL

https://api.sebhosting.com

Authentication

Most API endpoints require a valid JWT access token passed via the Authorization header:

Authorization: Bearer <access_token>

Access tokens are obtained from the Auth Service and expire after 15 minutes. Use the refresh endpoint to obtain new tokens.

Common Response Format

All services follow a consistent response pattern:

Health Check

{
  "service": "backend",
  "status": "healthy",
  "port": 4000,
  "uptime": 86400,
  "timestamp": "2026-02-14T06:19:07.261Z"
}

Status

{
  "service": "backend",
  "version": "1.0.0",
  "description": "API Gateway",
  "status": "operational",
  "timestamp": "2026-02-14T06:19:07.261Z"
}

Error

{
  "error": "Not found",
  "service": "backend"
}

Available Endpoints

Method	Path	Service	Description
GET	/health	API Gateway	Health check
GET	/status	API Gateway	Service version and status
GET	/stats	API Gateway	Docker container stats + host metrics
GET	/stats/logs/:name	API Gateway	Container logs
POST	/auth/register	Auth	Create account
POST	/auth/login	Auth	Login, get JWT
POST	/auth/refresh	Auth	Refresh access token
GET	/auth/me	Auth	Get current user
POST	/auth/logout	Auth	Logout, revoke tokens
GET	/dns/zones	API Gateway	List Cloudflare zones
GET	/dns/zones/:id/records	API Gateway	List DNS records
POST	/dns/zones/:id/records	API Gateway	Create DNS record
PUT	/dns/zones/:id/records/:rid	API Gateway	Update DNS record
DELETE	/dns/zones/:id/records/:rid	API Gateway	Delete DNS record

Service Health Endpoints

Every service exposes /health and /status endpoints:

curl https://auth.sebhosting.com/health
curl https://cms.sebhosting.com/health
curl https://cdn.sebhosting.com/health
curl https://cache.sebhosting.com/health
curl https://waf.sebhosting.com/health
curl https://ai-gateway.sebhosting.com/health
curl https://mcp.sebhosting.com/health