Apicurio-studio: Erro de página não encontrada ao tentar abrir um modelo existente no github.

Oi, obrigado pelo feedback. Infelizmente, no momento, o Apicurio não oferece suporte para leitura / gravação em YAML (como você descobriu). Há uma solicitação de recurso para isso aqui:

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

Não é difícil de fazer, mas existem alguns outros aprimoramentos à frente daquele na fila. :)

Como alternativa, você pode tentar converter de YAML em JSON, armazenar o resultado no GitHub e abri-lo. Irritante, eu sei, mas funcionaria até que possamos obter recursos adicionais para o apicúrio.

Nota: este ainda é um relatório de bug válido porque precisamos de melhores mensagens de erro ao adicionar / importar uma API. Se o recurso não puder ser encontrado (por exemplo, ao importar de um URL), devemos relatar isso ( não relatar um erro de "Página não encontrada"). Se o recurso existe, mas está em um formato incorreto, devemos relatar isso de forma diferente.

Não consegui fazer meu JSON OpenAPI 3 ou o exemplo vinculado acima funcionar hoje. Importar de um URL não funcionou 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

ou

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

Olá @ david4096 - o primeiro URL está falhando porque realmente não há nenhum conteúdo nesse URL. Ao menos quando clico nesse link não há arquivo. Na verdade, não existe uma pasta resources dentro de src/test para esse módulo:

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

No entanto, não é, obviamente, o conteúdo na segunda URL. O motivo pelo qual não está funcionando no Apicurio é que, infelizmente, ainda não suportamos puxar conteúdo de branches (apenas master). É evidente que falta funcionalidade, pois não é difícil oferecer suporte a branches.

Dito isso, acho que estamos indo na direção de ser capaz de Adicionar / Importar um design de API de uma URL arbitrária em vez de vários sistemas de controle de origem por meio de suas respectivas APIs (que é o que fazemos agora, puramente como um resquício de quando nos apoiamos mais fortemente nesses sistemas para armazenar os dados). Aumentarei a prioridade do recurso "importar de URL" e o incluirei na próxima versão.

Por enquanto, o que você pode fazer como solução alternativa é armazenar quaisquer APIs que deseja Adicionar / Importar no branch master de qualquer repositório github (talvez criar um repositório para esse propósito) e importar a partir daí.

Eu adicionei um tíquete para dar suporte a branches no controle de origem:

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

No entanto, acho que importar conteúdo de um URL arbitrário será um recurso mais útil, então vou abordar isso primeiro.

Olá @EricWittmann obrigado pela explicação!