OptimoAI API Production
Backend activo. Plataforma SaaS multi-producto con servicios de IA para WMS, SFA, TMS y POS. Autenticación multi-esquema, billing y ejecución de modelos.
Accesos rápidos
- Swagger UI /swagger
- Health check /api/core/ping/user
-
Token (Basic)
POST /api/auth/token -
Client credentials
POST /api/auth/client-token -
Docs internas
XtraDocuments/
Seguridad
Tres esquemas de autenticación según el tipo de cliente.
Módulos del sistema
Auth
Emisión de tokens JWT, registro, login, forgot-password y gestión de sesiones por claims y roles.
/api/auth/*
Core
Organizaciones, miembros, productos Optimo, planes, auditoría y utilitarios de plataforma.
/api/core/*
AI
Suscripciones, credenciales client-credentials, servicios de IA, ejecución de modelos y logs de uso.
/api/ai/* /api/execute/*
Billing
Métodos de pago, invoices, periodos de facturación, costos acumulados y límites de gasto.
/api/billing/*
Admin
Gestión de proveedores de pago, configuración de plataforma y overrides de suscripciones (rol Admin).
/api/admin/*
Portal
Frontend Blazor WASM conectado a este backend. Autoservicio de cuenta, suscripciones y credenciales.
http://localhost:5022
Endpoints clave
| Método | Ruta | Descripción | Auth |
|---|---|---|---|
| POST | /api/auth/token | Login — emite JWT de usuario | Basic |
| POST | /api/auth/client-token | Token de app (client credentials) | None |
| POST | /api/auth/register | Registro de nuevo usuario | None |
| GET | /api/core/ping/user | Health check con info de sesión | Bearer |
| GET | /api/ai/organizations/{id}/subscriptions | Lista suscripciones de una org | Bearer |
| POST | /api/ai/organizations/{id}/credentials | Crear client credential | Bearer |
| POST | /api/execute/{orgId}/subscriptions/{subId} | Ejecutar servicio de IA | Client Credentials |
| GET | /api/admin/payment-config | Config del proveedor de pago (singleton) | Bearer + Admin |
XtraDocuments/ApiManual.md.