Sobre el proyecto
Insomnia es un cliente de API de escritorio multiplataforma y de código abierto que cubre GraphQL, REST, WebSockets, Server-Sent Events (SSE), gRPC y otros protocolos compatibles con HTTP. Se distribuye para Mac, Windows y Linux, tiene licencia Apache-2.0 y es desarrollado abiertamente por Kong en GitHub.
Lo que el README indica que se puede hacer con él:
- Depurar APIs utilizando protocolos y formatos populares.
- Diseñar APIs con un editor nativo de OpenAPI y vista previa visual.
- Probar APIs con suites de prueba nativas y un ejecutor de colecciones.
- Simular APIs a través de un servidor de mocking en la nube o auto-alojado.
- Construir pipelines de CI/CD utilizando la CLI nativa de Insomnia (Inso) para linting y pruebas.
- Colaborar a través de las funciones de colaboración del producto.
- Extender el cliente con plugins de terceros.
Opciones de almacenamiento. Los proyectos, colecciones, especificaciones de diseño y otros recursos pueden mantenerse en diferentes backends, y el README establece que estos pueden combinarse por proyecto:
- Local Vault, para almacenamiento 100% local.
- Git Sync, utilizando cualquier repositorio Git de terceros sin pasar por la nube.
- Cloud Sync, para colaboración en la nube, opcionalmente con cifrado de extremo a extremo (E2EE).
Una función de Private Environments mantiene la configuración del entorno almacenada localmente, independientemente del backend de almacenamiento elegido para un proyecto.
Cuentas y planes. Insomnia puede usarse sin una cuenta a través del Scratch Pad local. La mayoría de las demás capacidades requieren una cuenta; el README explica que así es como el proyecto sostiene el desarrollo de una distribución de código abierto gratuita. Se describe un nivel gratuito como generoso, mientras que los planes premium añaden colaboración ilimitada, Git Sync, creación de organizaciones e inicios de sesión con proveedores de identidad de terceros (SAML, OIDC). Almacenar los datos de la API solo localmente o en Git es posible independientemente de tener una cuenta.
Desarrollo. El repositorio es un monorepo de Node.js; contribuir requiere Node.js y Git, con la versión correcta de Node indicada en .nvmrc. Los comandos comunes a nivel de raíz incluyen npm i, npm run lint, npm run type-check, npm test, npm run dev (recarga en vivo) y npm run dev:autoRestart (recarga en vivo del renderizador más reinicio automático del proceso principal). Los usuarios de Linux pueden necesitar paquetes de soporte como libfontconfig-dev en Ubuntu/Debian o libcurl-devel en Fedora, y es posible que necesiten borrar una instalación de Electron almacenada en caché si la instalación falla. La CLI Inso tiene su propio flujo de trabajo: npm i, npm run inso-start para compilar en modo watch, luego ./packages/insomnia-inso/bin/inso -v.
Ecosistema y comunidad. Los plugins se pueden encontrar e instalar desde el Insomnia Plugin Hub. El README señala proyectos comunitarios que incluyen Insomnia Documenter (generación de páginas de documentación de API), un importador de especificaciones de la API REST de GitHub y Swaggymnia (generación de documentación de Swagger para una API existente). Los informes de errores y las solicitudes de funciones se gestionan a través del rastreador de problemas de GitHub tras leer las pautas de problemas; las preguntas generales sobre el producto se manejan en la comunidad de Slack del proyecto. La documentación oficial se encuentra en docs.insomnia.rest.
Advertencias notables del README: el requisito de una cuenta para la mayoría de las funciones, además de planes de pago opcionales para colaboración y Git Sync. El código fuente en sí tiene licencia Apache-2.0.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.