Passei para deixar uma contribuição com relação ao swagger para Visual Studio 2019 e 2022 especificamente com desenvolvimento de apis c#: Erro MSB3024: 1 - Acesse as propriedades de seu projeto 2 - "Flagueie" Gerar um arquivo correspondente a documentação da api 3 - Na opção Caminho do arquivo de documentação XML preencha com o nome do projeto da api.xml 4 - Na opção Caminho base da saída clique em "Procurar" e apenas (sim é ridículo assim mesmo) clique em Selecionar Pasta e selecione onde está o projeto da api 5 - Parabéns, você resolveu essa "mundiça" de erro! Ps: CDFs, obrigado pelo conteúdo! Espero que vocês estejam bem pós os eventos daquela chuva que deu semanas atrás! Abraço!
Vocês são de mais. Falam sempre de TUDO, com muita qualidade. A galera de TI, tanto iniciante quanto senior que fica sempre revisando as coisas, todos nós precisamos muito de vocês.
Muito legal! Eu entrei em contato com o Swagger quando precisei fazer uma integração com um fornecedor. Não fazia ideia que isso existia, até estranhei no início, mas depois vi o quanto facilita a nossa vida! Eu poderia fazer testes para ver o retorno, os tipos de dados que os campos aceitavam, etc... Muito bacana! Nunca fui com a cara do postman... Valeu pessoas!
Que sensacional! Acredito fortemente que o dicionário do programador poderia virar um ou mais livros com tanto conteúdos incríveis como este!!! E uma contribuição existe também umaa outra opção não Open Source do OpenAPI é o RAML, que significa Restfull API Modeling Language, que trata de modelagem de APIs com YAML de uma forma bem bacana também e é muito utilizado pela Mulesoft, empresa e produto bem forte no mundo da integração, vale a pena conferir!!! Muito obrigado misters do Código Fonte 🤩🤩
Muito bom conhecer mais da história do Swagger! Senti falta de comentarem que evoluiu para o OpenAPI visto que hoje há vários recursos opensource com o nome e sponsor da OpenAPI. Também dá para usar no Docusaurus. Aqui na empresa fiz um gerador da spec a partir do código fonte em C#, quem sabe no futuro vira um projeto opensource, mas por enquanto boa parte é feita em Bash e AWK (o que complica a manutenção e portabilidade - vendo de migrar para Python). No final dá para juntar tudo e exportar via npm usando módulos para fazer o bundle e converter para Postman.
Acho bem legal a integração do swagger com o Spring do Java via SpringFox e SpringDoc. Gostaria muito de integrar com aplicações Java que NÃO usam o Spring, apenas o JPA.
A minha curiosidade ficou por conta de usar o Swagger, antes codar. Um concorrente não citado, seria o Insomnia Docs. Já se você usa o FastAPI, para gerar Endpoint, o nesmo possui Utilitários para lidar com a documentação automática da UI OpenAPI, incluindo Swagger UI (por padrão em /docs) e ReDoc (por padrão em /redoc).
galera estou iniciando como dev...mas ja sei um basiquinho implementei o swagguer autogen, pois entrei na empresa ja com a api pronta ai queria saber se alguem sabe porque o autogen falha pra pegar o tipo das chaves dentro do body? ou se ja viu isso acontecer, estou ha alguns dias nisso....ja resolvi as tags e tb o problema de nao pegar query(apenas param e body) mas resolvi exemplo do problema: model_X = { name: "string" code: number } mas no swagger, no caso json aparece assim: model_X = { name: "any" code: "any" } se conseguirem ou tiverem um minimo passo pra ajudar seria de grande ajuda, obrigado desde ja e desculpa pela extensao, pois nao achei alguem com esse problema ate agora ou nao soube pesquisar
@@CarlosSantos-vt9gb vai depender da tecnologia que você ta utilizando. Atualmente eu uso com nodeJS no framework Moleculer. Basicamente a gente tem um script que copia os yml pra uma pasta publica e utilizamos a lib "swagger-jsdoc" pra gerar o json com os dados do swagger baseado nessa pasta publica, ai agente tem uma pagina estatica html do swagger que carrega esse JSON.
Antes a gente usava dentro da classe também, ai mudamos pra ficar melhor, não foi eu quem fez a troca, então não vou saber te passar os detalhes, mas quando vou documentar só crio um arquivo yml novo la na pasta, dou o build la que copia os arquivos e pronto.
![I.N "HALLUCINATION" | [Stray Kids : SKZ-PLAYER]](http://i.ytimg.com/vi/n5B5q1Hwt_U/mqdefault.jpg)
Passei para deixar uma contribuição com relação ao swagger para Visual Studio 2019 e 2022 especificamente com desenvolvimento de apis c#:
Erro MSB3024:
1 - Acesse as propriedades de seu projeto
2 - "Flagueie" Gerar um arquivo correspondente a documentação da api
3 - Na opção Caminho do arquivo de documentação XML preencha com o nome do projeto da api.xml
4 - Na opção Caminho base da saída clique em "Procurar" e apenas (sim é ridículo assim mesmo) clique em Selecionar Pasta e selecione onde está o projeto da api
5 - Parabéns, você resolveu essa "mundiça" de erro!
Ps: CDFs, obrigado pelo conteúdo! Espero que vocês estejam bem pós os eventos daquela chuva que deu semanas atrás! Abraço!
Sugestão : Uma parte 2, seria usar Swagger web importando no postman
Vocês são de mais. Falam sempre de TUDO, com muita qualidade. A galera de TI, tanto iniciante quanto senior que fica sempre revisando as coisas, todos nós precisamos muito de vocês.
Precisei mexer com Swagger algumas semanas atrás, e para ter uma introdução, o primeiro lugar que procurei foi aqui. Que bom que esse vídeo saiu :)
Muito legal!
Eu entrei em contato com o Swagger quando precisei fazer uma integração com um fornecedor.
Não fazia ideia que isso existia, até estranhei no início, mas depois vi o quanto facilita a nossa vida!
Eu poderia fazer testes para ver o retorno, os tipos de dados que os campos aceitavam, etc... Muito bacana!
Nunca fui com a cara do postman...
Valeu pessoas!
Que sensacional! Acredito fortemente que o dicionário do programador poderia virar um ou mais livros com tanto conteúdos incríveis como este!!! E uma contribuição existe também umaa outra opção não Open Source do OpenAPI é o RAML, que significa Restfull API Modeling Language, que trata de modelagem de APIs com YAML de uma forma bem bacana também e é muito utilizado pela Mulesoft, empresa e produto bem forte no mundo da integração, vale a pena conferir!!! Muito obrigado misters do Código Fonte 🤩🤩
Estou trabalhando com swagger num back end que tô fazendo em um sistema legado. Ótimo vídeo, esclareceu muita coisa!
Muito bom !! Estava pesquisando sobre o swagger nesse final de semana.
Esse canal é incrível.
Muito bom conhecer mais da história do Swagger! Senti falta de comentarem que evoluiu para o OpenAPI visto que hoje há vários recursos opensource com o nome e sponsor da OpenAPI. Também dá para usar no Docusaurus. Aqui na empresa fiz um gerador da spec a partir do código fonte em C#, quem sabe no futuro vira um projeto opensource, mas por enquanto boa parte é feita em Bash e AWK (o que complica a manutenção e portabilidade - vendo de migrar para Python). No final dá para juntar tudo e exportar via npm usando módulos para fazer o bundle e converter para Postman.
Achei maravilhoso essa ferramenta, e o vídeo ajudou bastante, apresentando desde o que é, até como pode ser utilizada. ótimo conteúdo, valeu.
Aprendi mais com esse canal do que na Faculdade kkkk
Ajudou demais, estou fazendo teste em um desafio onde preciso utilizar essa ferramento e nunca utilizei uma API...
Vocês são sempre fantásticos! Parabéns!
Gabriel: FROnt-End Staff (FROES); Vanessa: desenvolvedora WEB (WEBER). Vá nessa, Gabriel! 😄Parabéns pelo conteúdo! Sucesso ao casal!
Eu uso o Talend API Tester, funciona como extensão do Chrome.
Muito bom o vídeo, parabéns
Acho bem legal a integração do swagger com o Spring do Java via SpringFox e SpringDoc. Gostaria muito de integrar com aplicações Java que NÃO usam o Spring, apenas o JPA.
Sugiro o episódio para a Linguagem Ruby.♥️💎
Importante citar que a API criada a partir do swagger pode ser utilizada para fazer a validação das requisições através do openApiValidator.
e como funciona isso? tentei pesquisar aqui mas n achei nada relevante
E pra desenvolver API eu uso o Application Integration do Informatica Cloud.
Nao diria sem esforco. Quando utilizei Swagger com RSpec, foi muito trabalhoso.
Também tem o Hoppscotch que é bom pra testar o retorno de apis
Muito bom!
Sugestão: FastAPI - python, cria a documentação enquando desenvolve a aplicação
apoiando
No R tem a package plumber que gera api swaģger
Lindos 🥰
Top!!!
Bom d+
A minha curiosidade ficou por conta de usar o Swagger, antes codar.
Um concorrente não citado, seria o Insomnia Docs.
Já se você usa o FastAPI, para gerar Endpoint, o nesmo possui Utilitários para lidar com a documentação automática da UI OpenAPI, incluindo Swagger UI (por padrão em /docs) e ReDoc (por padrão em /redoc).
Show
Swagger pra mim era um atirador de elite do Netflix
o que vocês agregam na comunidade não ta escrito
Fiquei deveras chateado achei que ia ver minha queridinha insomnia nos concorrentes🤣🤣🙃🤗
Tem o Docusaurus do Facebook
galera estou iniciando como dev...mas ja sei um basiquinho
implementei o swagguer autogen, pois entrei na empresa ja com a api pronta
ai queria saber se alguem sabe porque o autogen falha pra pegar o tipo das chaves dentro do body? ou se ja viu isso acontecer, estou ha alguns dias nisso....ja resolvi as tags e tb o problema de nao pegar query(apenas param e body) mas resolvi
exemplo do problema:
model_X = {
name: "string"
code: number
}
mas no swagger, no caso json aparece assim:
model_X = {
name: "any"
code: "any"
}
se conseguirem ou tiverem um minimo passo pra ajudar seria de grande ajuda, obrigado desde ja e desculpa pela extensao, pois nao achei alguem com esse problema ate agora ou nao soube pesquisar
É uma ótima ferramenta, mas classes ficam bem poluídas de comentários. É um trade off a se avaliar
Procura swagger inspector, ou algo assim. Com a api pronta, é fazer a requisição que ele gera o yml
da pra separar em um arquivo yml proprio
@@yanlucas9876 alguma dica de como fazer?
@@CarlosSantos-vt9gb vai depender da tecnologia que você ta utilizando. Atualmente eu uso com nodeJS no framework Moleculer. Basicamente a gente tem um script que copia os yml pra uma pasta publica e utilizamos a lib "swagger-jsdoc" pra gerar o json com os dados do swagger baseado nessa pasta publica, ai agente tem uma pagina estatica html do swagger que carrega esse JSON.
Antes a gente usava dentro da classe também, ai mudamos pra ficar melhor, não foi eu quem fez a troca, então não vou saber te passar os detalhes, mas quando vou documentar só crio um arquivo yml novo la na pasta, dou o build la que copia os arquivos e pronto.
Molecada terrível...