Apicurio-studio: Error de página no encontrada al intentar abrir un modelo existente desde github.

Hola, gracias por los comentarios. Desafortunadamente, en este momento, Apicurio no admite la lectura / escritura de YAML (como ha descubierto). Hay una solicitud de función para eso aquí:

https://github.com/Apicurio/apicurio-studio/issues/165

No es difícil de hacer, pero hay algunas otras mejoras antes de esa en la cola. :)

Como solución alternativa, puede intentar convertir de YAML a JSON, almacenar el resultado en GitHub y luego abrirlo. Es molesto, lo sé, pero eso funcionaría hasta que podamos obtener funciones adicionales en apicurio.

Nota: este sigue siendo un informe de error válido porque necesitamos mejores mensajes de error al agregar / importar una API. Si no se puede encontrar el recurso (por ejemplo, al importar desde una URL), entonces debemos informarlo ( no informar un error de "Página no encontrada"). Si el recurso existe pero tiene un formato incorrecto, deberíamos informarlo de otra manera.

No pude hacer que mi OpenAPI 3 JSON o el ejemplo vinculado anteriormente funcionen hoy. Importar desde una URL no funcionó para:

https://github.com/Apicurio/apicurio-studio/blob/master/back-end/hub-api/src/test/resources/io/apicurio/hub/api/beans/simple-api-3.0.json

o

https://github.com/david4096/data-object-schemas/blob/openapi3/openapi/data_objects_service.openapi.json

Hola @ david4096 : la primera URL falla porque realmente no hay contenido en esa URL. Al menos cuando hago clic en ese enlace, no hay archivo. De hecho, no hay carpeta resources dentro de src/test para ese módulo:

https://github.com/Apicurio/apicurio-studio/tree/master/back-end/hub-api/src/test

Sin embargo, es evidente que el contenido en la segunda dirección URL. La razón por la que no funciona en Apicurio es que, lamentablemente, todavía no admitimos la extracción de contenido de las ramas (solo el maestro). Claramente, esta funcionalidad falta, ya que no es difícil admitir ramas.

Dicho esto, creo que vamos en la dirección de poder Agregar / Importar un diseño de API desde una URL arbitraria en lugar de desde los diversos sistemas de control de fuente a través de sus respectivas API (que es lo que hacemos ahora, simplemente como un vestigio desde cuando nos apoyamos más en esos sistemas para almacenar los datos). Aumentaré la prioridad de la función "importar desde URL" y la incluiré en la próxima versión.

Por ahora, lo que puede hacer como solución alternativa es almacenar las API que desee Agregar / Importar en la rama maestra de cualquier repositorio de github (tal vez crear un repositorio para este propósito) e importar desde allí.

Agregué un ticket para apoyar a las sucursales en el control de código fuente:

https://github.com/Apicurio/apicurio-studio/issues/222

Sin embargo, creo que importar contenido desde una URL arbitraria será una característica más útil, así que lo abordaré primero.

Hola @EricWittmann gracias por la explicación!