Resumen de la documentación
Bienvenido
Comenzando
¡Bienvenido a la documentación de Sisk!
Sisk es un framework HTTP ligero y de código abierto para .NET. Puedes usarlo para crear un servicio …
Instalación
Puedes instalar Sisk a través de NuGet, la CLI de dotnet o otras opciones. Puedes configurar fácilmente tu entorno Sisk ejecutando este …
Soporte de AOT Nativo
.NET Native AOT permite la publicación de aplicaciones .NET nativas que son autosuficientes y no requieren que el tiempo de ejecución .NET …
Desplegando su aplicación Sisk
El proceso de desplegar una aplicación Sisk consiste en publicar su proyecto en producción. Aunque el proceso es relativamente sencillo, …
Trabajando con SSL
Trabajar con SSL en desarrollo puede ser necesario cuando se trabaja en contextos que requieren seguridad, como la mayoría de los escenarios …
Cadente
Cadente es una implementación experimental gestionada de un listener HTTP/1.1 para Sisk. Sirve como reemplazo del System.Net.HttpListener …
Configuración de reservas de espacios de nombres en Windows
Nota
Esta configuración es opcional y solo se requiere cuando deseas que Sisk escuche en hosts diferentes a “localhost” en …
Registros de cambios
Cada cambio realizado en Sisk se registra en el registro de cambios. Puedes ver los registros de cambios de todas las versiones de Sisk …
Preguntas Frecuentes
Preguntas frecuentes sobre Sisk.
¿Es Sisk de código abierto? # Totalmente. Todo el código fuente utilizado por Sisk se publica y se …
Fundamentos
Enrutamiento
El Router es el primer paso para construir el servidor. Es responsable de albergar objetos Route, que son puntos finales que asignan URLs y …
Manejo de solicitudes
Los manejadores de solicitudes, también conocidos como “middlewares”, son funciones que se ejecutan antes o después de que una …
Solicitudes
Las solicitudes son estructuras que representan un mensaje de petición HTTP. El objeto HttpRequest contiene funciones útiles para manejar …
Respuestas
Las respuestas representan objetos que son respuestas HTTP a solicitudes HTTP. Son enviadas por el servidor al cliente como una indicación …
Características
Registro
Puedes configurar Sisk para que escriba automáticamente registros de acceso y de errores. Es posible definir la rotación de logs, …
Eventos enviados por el servidor
Sisk admite el envío de mensajes a través de Server Sent Events de forma nativa. Puedes crear conexiones desechables y persistentes, obtener …
Sockets Web
Sisk también soporta websockets, como recibir y enviar mensajes a su cliente.
Esta característica funciona bien en la mayoría de los …
Sintaxis de descarte
El servidor HTTP se puede utilizar para escuchar una solicitud de devolución de llamada desde una acción, como la autenticación OAuth, y se …
Inyección de dependencias
Es común dedicar miembros y instancias que duran toda la vida de una solicitud, como una conexión a una base de datos, un usuario …
Transmisión de contenido
El Sisk admite la lectura y el envío de flujos de contenido desde y hacia el cliente. Esta característica es útil para eliminar la …
Habilitando CORS (Compartir Recursos entre Orígenes) en Sisk
Sisk tiene una herramienta que puede ser útil para manejar Cross-Origin Resource Sharing (CORS) al exponer tu servicio públicamente. Esta …
Servidor de Archivos
Sisk proporciona el espacio de nombres Sisk.Http.FileSystem, que contiene herramientas para servir archivos estáticos, listar directorios y …
Extensiones
Protocolo de Contexto de Modelo
Es posible crear aplicaciones que proporcionen contexto a modelos de agente usando grandes modelos de lenguaje (LLM) mediante el paquete …
Extensión JSON-RPC
Sisk tiene un módulo experimental para una API JSON-RPC 2.0, que le permite crear aplicaciones aún más simples. Esta extensión implementa …
Proveedores de Servicios
Los Proveedores de Servicios son una forma de portar tu aplicación Sisk a diferentes entornos con un archivo de configuración portable. Esta …
Proveedor de configuración INI
Sisk tiene un método para obtener configuraciones de inicio distintas de JSON. De hecho, cualquier canal que implemente IConfigurationReader …
Documentación de API
La extensión Sisk.Documenting le permite generar documentación de API para su aplicación Sisk de forma automática. Aprovecha la estructura …
Autenticación Básica (descontinuada)
Precaución
Descontinuado, no lo use. El paquete Sisk.BasicAuth ya no se mantiene y está obsoleto en NuGet, sin paquete de reemplazo. Su …
Proxy SSL (descontinuado)
Precaución
Descontinuado, no usar. El paquete Sisk.SslProxy ya no se mantiene y está obsoleto en NuGet, sin paquete de reemplazo. Ya no …
Avanzado
Configuración manual (avanzada)
Utilice la configuración manual cuando necesite ensamblar los componentes del servidor usted mismo, por ejemplo cuando un proceso debe …
Ciclo de vida de la solicitud
A continuación se explica todo el ciclo de vida de una solicitud mediante un ejemplo de una petición HTTP.
Recepción de la solicitud: cada …
Resolvedores de Reenvío
Un Resolvedor de Reenvío es un ayudante que ayuda a decodificar información que identifica al cliente a través de una solicitud, proxy, CDN …
Manejadores del servidor HTTP
En la versión 0.16 de Sisk, hemos introducido la clase HttpServerHandler, que tiene como objetivo ampliar el comportamiento general de Sisk …
Múltiples hosts de escucha por servidor
El Sisk Framework siempre ha soportado el uso de más de un host por servidor, es decir, un único servidor HTTP puede escuchar en varios …
Motores de servidor HTTP
El marco de trabajo Sisk se divide en varios paquetes, donde el principal (Sisk.HttpServer) no incluye un servidor HTTP base - por defecto, …