Descarga e instala
Un instalador de 115.9 MB con todo incluido: no necesitas Node ni nada más. Se instala solo para tu usuario, sin permisos de administrador, y se desinstala desde Configuración de Windows.
El instalador no lleva firma digital de código, así que Windows puede mostrar «Windows protegió tu PC». Elige «Más información» y luego «Ejecutar de todas formas».
Specix es software libre con licencia MIT: su código y todas sus versiones están en GitHub.
Descargar Specix-0.1.2-setup.exe| Versión | 0.1.2 | 29 oct 2026 |
|---|---|---|
| Formatos | OpenAPI 2.0 a 3.2 y AsyncAPI 2.0 a 3.1 | |
| Sistema | Windows 10 u 11 | 64 bits |
| Tamaño | Instalador | 115.9 MB |
| Idioma | Español | |
| SHA-256 |
db40199cc3bf4e63f6d15099ad6f600327e1ac7279c5a87180ae181062134dca
Descargar .sha256
| |
| Comprobar |
(Get-FileHash .\Specix-0.1.2-setup.exe).Hash
Pégalo en PowerShell, en la carpeta de la descarga. Debe dar la misma huella (Windows la muestra en mayúsculas).
| |
Escribe con ayuda
El editor conoce el esquema oficial de cada versión de OpenAPI y AsyncAPI: sugiere las claves y los valores válidos donde estás, completa cada $ref con los esquemas que existen y explica cada campo en español al pasar el ratón.
Con F12 saltas a la definición de una referencia. La ruta del cursor y la estructura del documento siempre están a la vista.
Válida de verdad
Cada cambio se revisa contra los esquemas oficiales de la OpenAPI Initiative y de la AsyncAPI Initiative, sin modificar. Los errores salen en el panel de problemas con su línea, explicados en español, y una referencia rota propone el nombre más parecido.
Al lado, la documentación se actualiza mientras escribes y abre la operación en la que está el cursor, con su cuerpo, sus parámetros y sus respuestas.
Lee el contrato
Con el botón Contrato ves la API completa como la lee quien la consume: un índice, cada operación con sus parámetros, el cuerpo y cada respuesta.
Cada cuerpo y cada respuesta se ven de dos formas. Como ejemplo, un JSON con datos: el del documento o, si no trae, uno que Specix arma con los formatos, valores y límites del esquema. Como esquema, un árbol con los tipos y los campos obligatorios, donde cada referencia se abre en su sitio.
Tu guía de estilo
El esquema dice qué es válido; la guía dice cómo lo quiere tu equipo. Specix aplica una guía con reglas en formato compatible con Spectral: nombres en camelCase, un resumen en cada operación, contacto y servidores definidos, esquemas sin usar.
La vista Gobernanza muestra cada regla, a qué aplica y cuántas veces falla en el documento; un clic te lleva al fallo. La guía es otro archivo del proyecto, así que se revisa en git como el resto.
Versiones que no cambian
Un proyecto de Specix es una carpeta: cada API tiene sus versiones, y los dominios guardan los esquemas que comparten todas. Una versión se trabaja como borrador y, al publicarla, queda en solo lectura con una huella.
Si alguien cambia una versión publicada, la revisión lo detecta. Para seguir, creas la siguiente versión a partir de ella. La pantalla Versiones reúne cada API con su estado, su fecha de publicación y su versión por defecto.
También eventos
Las APIs que publican eventos se describen en AsyncAPI, de la 2.0 a la 3.1, con el mismo editor, la misma validación y la misma guía. La documentación muestra cada canal con sus operaciones y el contenido de cada mensaje.
Para REST, Specix lee OpenAPI 3.0, 3.1 y 3.2, y también Swagger 2.0.
Un sitio para publicar
«Exportar sitio» convierte el proyecto en documentación HTML estática, con el nombre, el color y el logo de tu empresa: una página por versión y un índice con todas las APIs.
Las páginas no llevan scripts ni cargan nada de fuera, así que se pueden subir a cualquier servidor o abrir desde una carpeta.
Y en integración continua
La CLI usa el mismo núcleo que la app: specix lint . revisa todas las versiones con la guía del proyecto y falla si hay errores o si una versión publicada cambió. Con --formato sarif o junit, el resultado va directo a tu sistema de CI.
Además une una definición de varios archivos en uno, publica versiones y genera el sitio de documentación.
specix lint . apis/tienda/1.1.0/openapi.yaml:92:5 aviso La operación no tiene summary [guia/operation-summary] apis/tienda/1.1.0/openapi.yaml:107:7 aviso operationId debe ir en camelCase: «Cancelar_Pedido» [guia/operation-id-camelcase] 0 errores y 2 avisos en 4 archivos. specix lint . 0 errores y 0 avisos en 4 archivos. specix publish tienda 1.1.0 tienda 1.1.0 publicada. Sus archivos quedan congelados con su huella. specix docs . -o ../sitio 8 páginas en D:\Proyectos\sitio. Abre index.html en el navegador.
A tu manera
En Ajustes eliges el tema, el tamaño de letra y la sangría del editor, si Specix abre en el código o en el contrato, y la marca y el color del sitio que exportas. Cada cambio se ve al momento.
Desde ahí también renombras el proyecto y cambias su guía de estilo. Specix busca versiones nuevas y se actualiza solo al reiniciar.
Así nació Specix
Seis hitos y la salida, en 1 h 47 min de trabajo con IA, después de aprobar el diseño y el prototipo. Cada hito pasó sus pruebas antes de empezar el siguiente.
Preguntas
- ¿Necesito instalar Node u otra cosa?
- No: el instalador ya incluye todo. Basta con Windows 10 u 11 de 64 bits.
- ¿Por qué Windows dice que protegió mi PC?
- Porque el instalador no lleva firma digital de código. Puedes comprobar que el archivo es el original con su huella SHA-256, y luego elegir «Más información» y «Ejecutar de todas formas».
- ¿Specix envía mis definiciones a algún sitio?
- No. Todo se valida en tu equipo, sin cuenta y sin conexión. Las referencias a archivos remotos se señalan, pero Specix no las descarga.
- ¿Dónde se guardan mis APIs?
- En la carpeta que elijas, como archivos YAML o JSON normales: una carpeta por API y otra por versión. Puedes abrirlos con cualquier editor y subirlos a git. Al crear un proyecto nuevo, Specix pone plantillas para REST y para eventos.
- ¿Funciona con Mockix y Sendix?
- Lo que diseñas en Specix es OpenAPI estándar, así que Mockix ya puede crear un mock desde esa definición y revisar cada petición contra ella. La conexión directa entre las tres apps llega en las próximas versiones.
- ¿Qué viene después?
- Comparar versiones y avisar de los cambios incompatibles, comentarios sobre la definición, el ciclo con Mockix y Sendix, y generadores de código. Se anunciará en las novedades de ProtoHub.
- ¿Cómo actualizo o desinstalo?
- Desde la versión 0.1.2, Specix se actualiza solo: descarga la versión nueva en segundo plano y la instala al reiniciar. Si tienes una versión anterior, descarga este instalador y ejecútalo encima una vez: tus proyectos no se tocan. Para desinstalar, ve a Configuración de Windows, en Aplicaciones, o usa «Desinstalar Specix» en el menú Inicio.