Linter OpenAPI en línea — Reglas de estilo para specs

Analiza el estilo de tus specs OpenAPI 3.x (subconjunto estilo Spectral) — solo operaciones de paths, 100 % en el navegador.

Cargando…
Documentación Linter OpenAPI
Aplica un subconjunto de reglas estilo Spectral a las operaciones de paths.

Notas para desarrolladores

• Subconjunto estilo Spectral personalizado — no Spectral OAS completo. • Solo operaciones bajo paths (no webhooks/callbacks en v1). • Reglas: not-openapi, operation-operationId, operation-tags, info-contact, info-description, paths-kebab-case, operation-success-response, operation-description. • Lint en vivo con debounce; entrada Monaco JSON/YAML con autodetección. • Estados: passed / passed with warnings / failed. • Máximo 512 KiB. • El panel Resultados muestra contadores de reglas, rutas de incidencias y estadísticas de la spec.

Casos de uso

• Imponer operationId, tags y respuestas 2xx en operaciones de paths. • Detectar info.contact / description faltantes antes de publicar. • Preferir segmentos de ruta en kebab-case (o vN).

Ejemplos

Advertencias sin operationId

Antes

{ "openapi": "3.1.0", "info": { "title": "Pets", "version": "1.0.0" }, "paths": { "/pets": { "get": { "operationId": "listPets", "tags": ["pets"], "summary": "List pets", "responses": { "200": { "description": "OK" } } } } } }

Después

operation-operationId (warning) si falta operationId

solo respuestas default = fallo

Antes

{"openapi":"3.1.0","info":{"title":"t","version":"1","description":"d","contact":{"email":"[email protected]"}},"paths":{"/x":{"get":{"operationId":"x","tags":["t"],"summary":"s","responses":{"default":{"description":"e"}}}}}}

Después

operation-success-response (error) → failed

FAQ Linter OpenAPI

Preguntas frecuentes

¿Es Spectral completo?

No. La v1 incluye un subconjunto fijo estilo Spectral listado en las notas para desarrolladores — no es un ejecutor de rulesets personalizados.

¿Qué operaciones se analizan?

Solo operaciones de paths (get/put/post/delete/options/head/patch/trace). webhooks y callbacks quedan fuera del alcance en v1.

¿Qué significan passed / passed with warnings / failed?

failed = al menos un error; passed with warnings = solo advertencias; passed = sin incidencias. Nunca mostramos un verde «válido» si hay advertencias.

¿El lint hace validación de esquema?

No. El lint exige openapi 3.x + info, luego las reglas de estilo. Usa Validate OpenAPI para conformidad completa de esquema.

API y esquemas

Herramientas OpenAPI para formatear, validar y analizar tus specs.

Explorar otras categorías de herramientas

Minificar

Reduce código y assets para producción — minifica JavaScript, CSS, HTML, JSON y XML antes de gzip o un despliegue CDN.

Embellecer

Haz el código legible con una indentación coherente — embellece JavaScript, CSS, TypeScript, SCSS, LESS, Markdown, GraphQL, SQL, YAML y más en tu navegador.

Desminificar

Expande código minificado o comprimido — desminifica JavaScript, CSS, TypeScript, SCSS, LESS, SQL, YAML y otros formatos al depurar o revisar.

Conversión

Transforma datos entre JSON, YAML, XML y CSV en local — sin subidas a un servidor.

Preprocesadores CSS

Compila SCSS o LESS a CSS estándar en el navegador — combínalo con embellecer o minificar para un flujo de hoja de estilos completo.

Herramientas JSON

Valida, formatea, compara y explora payloads JSON — complementarias a minificadores y convertidores.

Herramientas SVG

Previsualiza, optimiza con SVGO, exporta Data URI, redimensiona, embellece, convierte a JSX y valida SVG — todo en tu navegador.

DevOps e Infra

Formato, validación y minificación de Terraform HCL, formato y lint de Dockerfile, validación de Docker Compose y .env.

CI/CD

GitHub Actions y GitLab CI — formatear YAML y comprobar la estructura de workflows/jobs en el navegador.

Logs y observabilidad

JSON/NDJSON línea a línea y access logs de Nginx/Apache — formato, filtro, validación y CSV/TSV.

Kubernetes

Manifiestos multi-doc, validación estructural, starters Ingress/Deployment y formato de values de Helm.

Red / IP

CIDR, subredes y ayudas IPv4/IPv6 — en tu navegador.

Seguridad y tokens

JWKS, certificados X.509 y escaneo de secretos — en local en el navegador.

Codificación

Codifica o decodifica Base64, componentes URL y entidades HTML — solo en el cliente.

Utilidades para desarrolladores

Timestamps, UUID, ULID, Nanoid, cron, contraseñas, regex, slugify, bases numéricas, mayúsculas, diff de texto y chmod — todo en el cliente.

Texto y Markdown

Cuenta palabras, genera TOC Markdown y limpia listas de líneas — todo en tu navegador.

IA y LLM

Conteo de tokens, estimación de costes y ajuste a la ventana de contexto — 100 % en el navegador.

Datos de prueba

Valores de campo sintéticos para fixtures y seed de BD — primero números de teléfono en rangos reservados.

Serialización

Serializa y deserializa estructuras PHP junto a los flujos JSON.