Reseñas y detalles del producto de Stoplight

La organización de los puntos finales y modelos, así como la documentación en línea. Reseña recopilada por y alojada en G2.com.

A veces me confundo al intentar encontrar un modelo que guardé por error en objetos compartidos. Podría haber un mensaje de confirmación antes de este tipo de acción (algo como: ¿realmente quieres compartir este modelo?) Reseña recopilada por y alojada en G2.com.

Las características de diseño colaborativo de API de OAS de Stoplight han sido extremadamente valiosas para impulsar a nuestro equipo a abordar las deficiencias de API para varios de nuestros servicios. Se pueden formar equipos y asignar a APIs específicas que se están desarrollando para la organización. La herramienta en sí ha permitido a nuestros equipos abordar APIs faltantes o deficientes para varios servicios, y hacerlo de una manera compatible con OAS. En la mayoría de los casos, los servicios ya existían pero no tenían API (o eran limitadas). Stoplight promovió una incorporación rápida y con pocas horas de trabajo de los desarrolladores y el diseño subsiguiente de API para abordar las deficiencias. En el caso de un servicio recién agregado, Stoplight permitió al equipo adoptar un enfoque de API primero, lo cual hasta ahora ha sido raro para nosotros y probablemente no habría sucedido, o no con suficiente claridad y formalismo, sin Stoplight. Nuestro grupo es pequeño, con desarrolladores generalmente responsables de la mayoría de las fases del desarrollo de software de sus proyectos asignados y pocos procesos formales. La incorporación de Stoplight en los procesos de desarrollo existentes fue recibida muy positivamente y no implicó altos costos de incorporación u oportunidad, lo cual era un requisito clave vital. El uso de Stoplight puso un mayor énfasis en el diseño de API antes de la implementación, permitiendo que se planificara mejor, en algunos casos revisado, contribuido por otros miembros del equipo, y se implementara ligeramente más rápido y con mayor alcance del que se habría logrado de otra manera. Reseña recopilada por y alojada en G2.com.

Al igual que algunos otros, también fuimos incorporados a una versión beta de Stoplight Next, lo que causó algunos problemas inicialmente. Sin embargo, debido a que esto coincidió con la necesidad de los miembros del equipo de llenar vacíos de conocimiento con respecto a OAS, el efecto de estos problemas fue menor. Actualmente estamos teniendo más problemas con la publicación de la documentación (y la especificación OAS, disponible a través de la API) y la presentación de la documentación de una manera atractiva. Esto también puede reflejar nuestra falta de familiaridad con las capacidades, o puede reflejar limitaciones en la producción de documentación de Stoplight; no estamos seguros todavía. Además, tenemos necesidad de documentación de API no OAS, aunque esto puede estar fuera del alcance de Stoplight. Reseña recopilada por y alojada en G2.com.

Después de evaluar varios productos para documentar múltiples APIs REST - Postman, Swagger, API Blueprint y el principal diferenciador para mí fueron:

- la capacidad de mezclar documentación al estilo OAS y páginas Markdown, proporcionando una herramienta integral para escribir toda la documentación de la API.

- un editor agradable para el documento OAS, que ofrece tanto una interfaz de usuario como una forma de editar datos JSON directamente.

El equipo fue muy receptivo a las preguntas durante la prueba, y después de convertirse en cliente de pago. También han estado abiertos a mis solicitudes de características.

La nueva versión (Next) ha evolucionado muy bien desde su lanzamiento hace unos meses. Reseña recopilada por y alojada en G2.com.

Comencé a usar StopLight cuando Next estaba en beta. Tuve un par de problemas menores, pero el equipo fue receptivo al abordarlos y no he encontrado problemas durante semanas. Reseña recopilada por y alojada en G2.com.

La capacidad de contribuir con varias personas a la misma especificación. Lo cual se traduce a oas bajo el capó. La facilidad de definir modelos y pruebas en la herramienta. Publicar automáticamente documentación en html... Reseña recopilada por y alojada en G2.com.

El mismo usuario dentro de múltiples organizaciones es facturado en cada organización. Dentro de nuestra empresa usamos stoplight para todos nuestros clientes, pero cuando el cliente quiere contribuir, necesitamos crear un proyecto en una organización separada (de esta manera el cliente no puede ver los otros proyectos de otros clientes). El inconveniente es que cada usuario de nuestro lado es facturado por cada organización. Reseña recopilada por y alojada en G2.com.

Me encanta lo accesible que es Stoplight para todos en nuestra organización. Se ha convertido en una herramienta esencial para planificar y organizar nuestra API, una herramienta que incluso las personas no técnicas entienden y comprenden.

También me encanta la documentación alojada: es rápida y estable. Reseña recopilada por y alojada en G2.com.

Entro en Stoplight realmente acostumbrado a la especificación OpenAPI (swagger). A veces es realmente difícil averiguar cómo hacer algo con Stoplight que ya sé cómo hacer en la especificación OpenAPI. Reseña recopilada por y alojada en G2.com.

As a Technical writer I need a friendly tool, with an easy-to-use interface so I can better collaborate with the development teams in the development and review of the documentation of our APIs. Its integration with Git allows teams to collaborative in a coordinated way. Reseña recopilada por y alojada en G2.com.

Stoplight seems to be an immature tool yet, so now and them I stumble upon errors, or I miss things that I think should be there already. For example, I’ve noticed than when had unsaved changes, Stoplight wouldn’t make me aware of that, and then I’d lose my work (This is fixed now). Reseña recopilada por y alojada en G2.com.

Diseñar una API es extremadamente intuitivo y simple. Las pruebas simuladas son fáciles de configurar. Estamos habilitando el desarrollo concurrente de front-end y back-end según un contrato acordado definido en Stoplight. Reseña recopilada por y alojada en G2.com.

Gestión de modelos comunes y respuestas entre proyectos. En un mundo de microservicios, estamos definiendo muchos proyectos de semáforo, sin embargo, hay elementos comunes que nos gustaría compartir entre esos proyectos. Hacer esto más fluido sería un gran ahorro de tiempo. Reseña recopilada por y alojada en G2.com.

La simplicidad al compartir especificaciones de API con compañeros de trabajo y permitir que todos los usuarios cambien esas especificaciones. La documentación generada es otra característica positiva. Finalmente, el hecho de que todavía podemos editar directamente la especificación del código en algunos casos donde podemos simplemente copiar desde otra ubicación. Reseña recopilada por y alojada en G2.com.

Difícil de usar el versionado. Una característica destacada sería el historial de cambios, incluso si es solo localmente. Reseña recopilada por y alojada en G2.com.

Organización de la interfaz de usuario, simulación, uso inmediato, etc. Reseña recopilada por y alojada en G2.com.

El versionado/commits es extraño/raro. No hay documentación disponible. No hay una manera clara de tener ramas actuales frente a ramas en progreso del diseño de la API. Echamos un vistazo a Stoplight Next y estábamos emocionados por las cosas que aparecían allí, pero no había documentación que pudiera encontrar fácilmente, así que teníamos miedo de dar el salto. Reseña recopilada por y alojada en G2.com.

Stoplight tiene una excelente interfaz para el diseño de API, documentación y luego generar automáticamente una especificación swagger. El servicio es excelente y el equipo es receptivo a los comentarios. Reseña recopilada por y alojada en G2.com.

Estamos en una versión anterior de Stoplight y no hemos cambiado a la nueva versión. Reseña recopilada por y alojada en G2.com.