Le Piramidi Company

Welcome to Le Piramidi

We are glad you are here. This is the official API gateway for Le Piramidi — a secure, multilingual platform built to power our digital services with reliability and care.

System health API auth routes
Environment production Port 3000 Status Healthy Locales EN · AR · IT

MongoDB

Online

Document database with auto-reconnect and user profiles

Redis

Online

Cache client with exponential backoff retry

WebSocket

Online

Active connections: 0

Socket.io with JWT-protected handshake

File uploads

Online

Max size: 5 MB (images), 20 MB (drawings)

Allowed: image/jpeg, image/png, image/gif, image/webp, image/bmp, image/tiff, image/heic, image/heif, image/avif

What powers Le Piramidi

Core capabilities already implemented and ready for our products and teams.

Security layer

  • Helmet security headers
  • CORS with origin allowlist
  • Rate limiting on global and auth routes
  • JWT bearer authentication guard

Internationalization

  • English, Arabic, and Italian locales
  • Localized API error messages
  • RTL layout support for Arabic
  • Accept-Language header detection

Authentication

  • User registration with role assignment
  • Secure login and JWT issuance
  • bcrypt password hashing
  • WebSocket handshake authentication

Field service modules

  • Users, projects, vehicles, and tasks
  • Role-based access for admins and workers
  • Geofenced daily shift assignments with telemetry
  • Native geofence trigger webhook support

Developer experience

  • Zod env validation and request schemas
  • Centralized error handling
  • Structured logging in production
  • Graceful shutdown on SIGTERM / SIGINT

API endpoints

Routes and channels exposed by this server.

Method Path Description Status
GET / Le Piramidi welcome page Live
GET /health Liveness and dependency health dashboard Live
POST /api/v1/auth/register Create a new user account Live
POST /api/v1/auth/login Authenticate and receive a JWT access token Live
GET /api/v1/auth/me Return the authenticated user profile Live
POST /api/v1/auth/users Admin-only user creation with role assignment Live
GET /api/v1/users Admin-only list of all users Live
GET /api/v1/users/:id Fetch a user profile (self or admin) Live
PATCH /api/v1/users/:id Update user profile with role-based field policies Live
DELETE /api/v1/users/:id Admin-only soft delete (deactivate user) Live
GET /api/v1/projects List projects (all for admin, assigned for workers) Live
POST /api/v1/projects Admin-only project creation with geofence bounds Live
GET /api/v1/projects/:id Fetch a project by id Live
PATCH /api/v1/projects/:id Admin-only project update Live
DELETE /api/v1/projects/:id Admin-only project deletion Live
GET /api/v1/vehicles List fleet vehicles Live
POST /api/v1/vehicles Admin-only vehicle registration Live
PATCH /api/v1/vehicles/:id Admin-only vehicle update Live
DELETE /api/v1/vehicles/:id Admin-only vehicle deletion Live
GET /api/v1/worker/shifts List daily shift assignments for the active worker Live
GET /api/v1/worker/shifts/reports Completed shift report archive for the active worker Live
POST /api/v1/files/profiles Authenticated avatar upload with WebP compression Live
GET /api/v1/files/:category/:filename Authenticated secure file streaming by category Live
WS /socket.io Real-time channel — pass Bearer JWT in handshake Live

Monitor service health at GET /health or request JSON with ?format=json. GET /health · ?format=json

© 2026 Le Piramidi Company — refresh for live status.