Pros y Contras de Stoplight

Una de las características destacadas de Stoplight.io es su interfaz fácil de usar, lo que la hace accesible tanto para desarrolladores experimentados como para principiantes. El diseño bien estructurado de la plataforma permite a los usuarios navegar sin esfuerzo por varias secciones, incluyendo el diseño de APIs, la definición de modelos de datos y la generación de documentación completa.

Además, Stoplight.io ofrece una variedad de herramientas para mejorar el desarrollo de APIs. La función "Design" facilita la creación de endpoints de API, haciendo conveniente modelar y visualizar estructuras de datos utilizando la Especificación OpenAPI. Además, la capacidad de realizar pruebas en vivo de API es una gran ventaja, asegurando que los desarrolladores puedan identificar y rectificar problemas de manera rápida. Reseña recopilada por y alojada en G2.com.

Aunque Stoplight.io tiene una gama de características impresionantes, hay algunas limitaciones que deben abordarse. En primer lugar, el rendimiento de la plataforma podría mejorarse, especialmente al manejar proyectos de API grandes. Mientras que funciona admirablemente con proyectos pequeños a medianos. Reseña recopilada por y alojada en G2.com.

Stoplight hace que el diseño de API sea realmente fácil. La interfaz gráfica es muy intuitiva de usar. Puede cambiar fácilmente a la vista de código y volver. Incluso siendo una interfaz web, funciona en tiempo real cuando se tienen otras instancias abiertas. La integración con git está bien hecha y la validación de la guía de estilo ayuda a evitar errores y mantener la uniformidad en todo el diseño de API.

El ejemplo perfecto de cómo debería ser el software. Reseña recopilada por y alojada en G2.com.

No me he encontrado con artículos reales que no me gusten. Lo único que podría ser realmente beneficioso sería la opción de tener un llamado portal de desarrolladores de API. Una forma de catalogar las API disponibles del negocio y simularlas para usuarios que no cuentan en el conteo de 'usuarios'. Otra cosa es la enorme diferencia de precio para la versión pro. Podría ver esto también como un pro porque significa que las características más importantes están disponibles a un precio razonable, pero preferiría ver la capacidad de seleccionar características separadas de la versión pro sin la necesidad de pasar completamente a la pro y pagar el precio pro. Reseña recopilada por y alojada en G2.com.

Estructurar y documentar todas las características de tu API es muy fácil con Spotlight. Te ayuda a crear especificaciones OpenAPI escalables y fáciles de exportar, lo cual es muy útil y estructurado. Reseña recopilada por y alojada en G2.com.

Carece de herramientas de edición masiva, lo que puede hacer que las cosas sean un poco manuales, pero si estás familiarizado con json/yaml, ¡puedes ser más eficiente! La función de publicación podría ser un poco mejor con más contexto sobre lo que está cambiando dentro de la documentación de la API para una mejor visibilidad. Reseña recopilada por y alojada en G2.com.

First of all it looks like modern tools about the UX - it's really user-friendly and you can do everything without reading tons of documentation. You just open the page and start creating your API models and endpoints.

About possibilities it offers - you can create an endpoint with all needed parameters which some of them can be linked schemas created aside in the same UI. Entities can have its own children also linked from other schemas. There is also an export straight to YAML/JSON for external use. I like the versioning and email notifications with recent changes after publishing. I hope Stoplight will be continuosly growing. Reseña recopilada por y alojada en G2.com.

I don't see any significant cons of the product. Maybe it could be less expensive or free for internal projects (special license), but the cost it's not something horrible. Maybe it could have some more generated/automated things based on AI for an instance. Reseña recopilada por y alojada en G2.com.

- Permite generar documentación en muchos formatos

- Proporciona una URL de API simulada con la que podemos probar las APIs

- Proporciona características como la puerta de enlace de API

- Se conecta con Github para que podamos gestionar el diseño de API usando CI/CD. Reseña recopilada por y alojada en G2.com.

- El costo es la principal preocupación. Su plan profesional que nuestra empresa está utilizando nos cuesta aproximadamente $500 cada mes.

- Tiene una integración limitada con herramientas y servicios existentes. Reseña recopilada por y alojada en G2.com.

Un paso por encima de otras plataformas API, Stoplight tiene una rica colaboración integrada con sistemas de gestión de tareas, Slack, etc., que nos permite dejar comentarios contextuales entre nosotros y discutir la superficie de la API. Reseña recopilada por y alojada en G2.com.

Si tuviera que elegir algo, me llevó un poco de tiempo acostumbrarme a cómo usarlo: cambiar entre la vista de código y la vista textual. Pero no es un obstáculo en absoluto. Reseña recopilada por y alojada en G2.com.

Su integración con GitHub y sus guías de estilo predeterminadas. Desarrolladores y diseñadores, incluso personas no técnicas, pudieron rápidamente comenzar a usar la creación de prototipos de API con Stoplight. Reseña recopilada por y alojada en G2.com.

El costo de las licencias de espectadores es demasiado caro. Es casi similar al costo de la licencia de creador, cuando debería haber sido menos de la mitad del costo de la licencia de creador. Reseña recopilada por y alojada en G2.com.

Me gustan muchas de las características que la API de construcción suele proporcionar, el editor visual, y que puedes trabajar con el servidor de prueba, y es fácil construir APIs con especificaciones. También me gustó el servidor simulado porque es fácil de entender y muy útil. Reseña recopilada por y alojada en G2.com.

Me gustan la mayoría de sus características y no veo ningún inconveniente o al menos algo que afecte su rendimiento. Reseña recopilada por y alojada en G2.com.

Stoplight proporciona una experiencia basada en proyectos para recopilar tanto las Especificaciones Open API como la documentación en Markdown y organizarlas para crear una experiencia de documentación API atractiva y sencilla. Todos los proyectos pueden organizarse en grupos de permisos para todos los niveles de acceso, incluidos privado, interno, socio/invitado y público. Permite una búsqueda centralizada en todos los activos y proyectos desde la raíz, lo que proporciona una experiencia empresarial muy atractiva que ofrece conciencia y descubrimiento para que diferentes miembros de la organización puedan buscar ampliamente entre docenas o cientos de especificaciones Open API y documentación. Además, Stoplight proporciona componentes web de alta fidelidad para integrar ciertos proyectos o toda la experiencia del portal personalizada dentro de su propia aplicación web. La adición de proyectos de código abierto integrados y auto-publicados como spectral y prism en su plataforma añade capas de gobernanza de guías de estilo que ahora son el estándar de la industria que prácticamente inventaron. Reseña recopilada por y alojada en G2.com.

Si bien Stoplight tiene muchas características atractivas en torno a la Documentación y Descubrimiento de API, lucha principalmente con el flujo de trabajo de Diseño de API. Un Studio local y un Studio basado en la web proporcionan una gran experiencia de edición de Open API, pero carecen de capacidades en torno al ciclo de vida, la gestión de versiones y la promoción de esos activos. Dada la corta edad de Stoplight, espero que estas madureces del ciclo de vida estén disponibles con el tiempo, pero pueden plantear grandes preocupaciones para las organizaciones que requieren este nivel de complejidad. Usos avanzados adicionales del diseño de Open API en la empresa incluyen modelos y esquemas reutilizables, que no se proporcionan en Stoplight hoy en día. Reseña recopilada por y alojada en G2.com.

Stoplight es probablemente la herramienta de desarrollo de API centrada en OpenAPI más bonita y completa/pulida que está disponible. Otras herramientas se sienten un poco más como "herramientas" en lugar de software, y fallan en la traducción entre el diseño WYSIWYG y la validación de la especificación OpenAPI resultante. Stoplight hace un buen trabajo traduciendo entre los dos y tiene una buena UI/UX. Reseña recopilada por y alojada en G2.com.

Algunas cosas no están del todo pulidas. La función de propuesta puede ser confusa/engorrosa de usar. Además, Stoplight no va más allá de la especificación OpenAPI, lo cual puedo entender, pero hay oportunidad de mejora en ese aspecto. Por ejemplo, Stoplight no admite el método HTTP QUERY, que aún no está oficialmente en la especificación OpenAPI, pero otras herramientas como Postman sí lo admiten de todos modos. Reseña recopilada por y alojada en G2.com.