Olá pessoal, às vezes queremos apenas convidar outra pessoa para revisar o design da API sem atualizar as operações. Então, poderíamos adicionar uma função somente leitura para colaboradores? Valeu!
Boa ideia, com certeza. Espero abordar muito esse tipo de coisa em breve, apresentando projetos e talvez equipes. Sei que venho dizendo isso há algum tempo, mas ainda é uma grande prioridade e é apenas uma questão de encontrar a largura de banda.
Não tenho certeza se você notou o novo recurso do Apicurio Studio que acredito que possa atender a esse requisito. É chamado de Share Docs e está disponível no menu action / kebab para cada design de API OpenAPI 2 ou 3:
Ao clicar nele, você obterá uma caixa de diálogo que permitirá ativar / desativar o compartilhamento para o design da API:
Quando o compartilhamento está habilitado, qualquer usuário poderá visualizar a documentação do design da API. Por exemplo, aqui está o link da imagem acima:
https://studio-ws.apicur.io/sharing/76f236d3-1312-4548-a4d1-400487188c66
Olá Eric, experimentei esse recurso hoje, o design atual pode nos ajudar a compartilhar a documentação, mas quando uma documentação é compartilhada, qualquer pessoa pode visualizá-la, o que pode não ser seguro. Além disso, outros membros da equipe precisam visitar o URL compartilhado diretamente, em vez de encaminhar para a página compartilhada por meio de sua lista de projetos. E a sua ideia?
OK, obrigado pelo feedback, @yuanhuiliu - a atualização do Projeto e das equipes ainda está em andamento. Então, esperançosamente, podemos adicionar uma função somente leitura quando fizermos esse trabalho.
Comentários muito úteis
OK, obrigado pelo feedback, @yuanhuiliu - a atualização do Projeto e das equipes ainda está em andamento. Então, esperançosamente, podemos adicionar uma função somente leitura quando fizermos esse trabalho.