Reseñas y detalles del producto de Stoplight

Fuimos con Stoplight para el generador de código multilingüe. A los desarrolladores les encanta. Reseña recopilada por y alojada en G2.com.

No hay problemas importantes. OpenAPI es complicado y Stoplight hace un buen trabajo al facilitar su uso. Reseña recopilada por y alojada en G2.com.

El editor de esquemas con referencias de modelos es una herramienta muy útil para construir y modificar rápidamente las definiciones de rutas. También es posible compartir documentación pública basada en el esquema. Reseña recopilada por y alojada en G2.com.

No hay soporte para OAS 3. No hay posibilidad de añadir reglas de lint personalizadas. Reseña recopilada por y alojada en G2.com.

Los editores de JSON Schema, las importaciones y el editor de tutoriales con ejemplos interactivos. Reseña recopilada por y alojada en G2.com.

Falta de soporte para GraphQL (playground en ejemplos, hasta donde sé). Falta de una manera fácil de documentar múltiples APIs con diferentes niveles de acceso y compartir recursos y esquemas. Reseña recopilada por y alojada en G2.com.

Stoplight ha puesto una interfaz de usuario increíble sobre la documentación de API. Sus herramientas son rápidas, fáciles de usar y realmente bien hechas. Además, siempre tienes acceso para ver los datos de Swagger que impulsan la aplicación, lo cual es realmente útil para usuarios más técnicos. Reseña recopilada por y alojada en G2.com.

Fue difícil para nuestro equipo mantener esto actualizado. Una integración más simplificada con AWS API Gateway habría sido genial (y puede que exista ahora, no lo he comprobado). Reseña recopilada por y alojada en G2.com.

La interfaz gráfica es excelente y el hecho de que soporte los estándares Open-API me hace sentir seguro de que podemos construir nuestras herramientas a su alrededor. Reseña recopilada por y alojada en G2.com.

El equipo de semáforos me ha asegurado que esto se solucionará en la próxima versión -- La herramienta tiene un enfoque centrado en la hospedaje en línea, lo que ha hecho que sea un desafío integrarla en nuestra base de código de múltiples ramas donde se desarrollan nuevas funciones en diferentes ramas. Reseña recopilada por y alojada en G2.com.

La capacidad de agregar y manipular elementos rápidamente con el diseñador, pero aún tener la capacidad de hacer cambios directamente en los datos JSON. Además, la capacidad de trabajar con todos los proyectos a través de git hace posible colorear fuera de las líneas. Reseña recopilada por y alojada en G2.com.

Me gustaría poder usar la edición de YAML, tener la capacidad de segmentar versiones para que, por ejemplo, la v1.1 se publique, pero aquellos con suficiente autorización puedan acceder a la v1.2 que está en desarrollo.

Además, la versionado debería ser semver completo, para poder tener 1.1.1 y 1.1.2, no solo 1.11 y 1.12. Reseña recopilada por y alojada en G2.com.

La personalización de la prueba del contrato de API y la adición de pruebas adicionales es excelente. Poder personalizar la prueba a través de JavaScript es una ventaja. Reseña recopilada por y alojada en G2.com.

La aplicación de escritorio Stoplight Next presenta errores al intentar abrir una nueva ventana. Reseña recopilada por y alojada en G2.com.

Fácil de generar y estructurar la documentación de tu API. También admite el alojamiento de múltiples APIs con modelos e información compartidos. Reseña recopilada por y alojada en G2.com.

El registro de auditoría es inútil para averiguar los cambios en el documento realizados por otras personas. Estábamos buscando una herramienta para gestionar y monitorear la API, pero Stoplight no pudo cumplir con los requisitos aquí. Reseña recopilada por y alojada en G2.com.

Es una herramienta muy útil para el usuario no técnico (lado empresarial) para formular y estructurar la API antes de que se implemente. Puedo documentar el contexto empresarial con la estructura técnica de la API y generar documentación de API fácil de usar a partir de ella. Reseña recopilada por y alojada en G2.com.

No hay forma de compartir el borrador de la documentación de la API solo con un público limitado. El precio de la documentación alojada no es razonable para equipos pequeños si se utilizará solo para acordar la estructura de la API. Y el módulo de diseño de Stoplight requiere cierta experiencia antes de poder revisar la API propuesta. Reseña recopilada por y alojada en G2.com.

Diseño de API intuitivo herramienta GUI

Muy buen soporte

Muy rentable Reseña recopilada por y alojada en G2.com.

Cuando varias personas están trabajando en el diseño de API, no hay mucha información sobre quién cambió qué. Se necesita más trabajo en esa área. Reseña recopilada por y alojada en G2.com.