sgcREST: servidor de API REST y componentes OpenAPI para Delphi y C++ Builder

TsgcHTTPRESTServer extiende el TsgcHTTPServer estándar con gestión de CORS a través de CORSOptions, y dos propiedades para complementos opcionales: ServerStats y Tenancy. TsgcHTTPServerStats cuenta cada petición por clase de estado, registra la latencia mínima, media y máxima, y sirve un endpoint /metrics en formato Prometheus además de un endpoint JSON /health, con GetEndpointStats para un desglose por ruta. TsgcHTTPServer_Tenancy resuelve el tenant de quien llama a partir del nombre de host, un segmento de la ruta, una cabecera de la petición o un claim JWT, y la propiedad Tenant del propio servidor lee el resultado para la petición que se está atendiendo. TsgcHTTPServer_Users es un cuarto complemento, independiente: un almacén local de cuentas con AddUser, ValidateCredentials, etiquetas de rol y hash de contraseña con sal, con cifrado en reposo opcional, consultado directamente desde un manejador de ruta en lugar de conectarse al servidor como propiedad.

Spec-first: carga un documento OpenAPI 3.0 o 3.1 y TsgcOpenAPIRouteTable construye la tabla de rutas a partir de su sección paths automáticamente. Una petición encontrada llega como un TsgcOpenAPIServerContext, con acceso tipado a parámetros de ruta y de consulta, ayudantes de cuerpo y RespondJSON/RespondError, TsgcOpenAPIServerHandler envuelve cada llamada en BeforeHandle, AfterHandle y HandleException, y TsgcOpenAPIJSONValidator valida cuerpos, parámetros de consulta y de ruta contra los JSON Schemas que declara la especificación. Code-first invierte la fuente de la verdad: anota una clase Delphi normal con los atributos sgcServiceContract, sgcRoute, sgcHttpGet/sgcHttpPost y sgcFromPath/sgcFromQuery/sgcFromBody, y TsgcOpenAPICodeFirstScanner.GenerateSpec produce el documento OpenAPI directamente a partir de su RTTI, sin YAML que escribir a mano. Combínalo con TsgcOpenAPICodeFirstDispatcher y los métodos anotados se invocan directamente para cada operación, sin cadena de despacho manual. Code-first requiere Delphi XE7 o posterior.

TsgcOpenAPI_Client es un cliente de runtime genérico para cualquier endpoint que describa un documento OpenAPI: HTTP_REQUEST transporta la llamada, Authentication cubre autenticación Basic y tokens bearer además de OAuth2 y JWT genéricos, y OnBeforeRequest, OnUpload y OnDownload la siguen.