Anunciando as atualizações para a experiência de API REST
Esta postagem foi escrita por Jessie Huang, gerente de programa na equipe docs.microsoft.com.
Hoje, temos a satisfação de anunciar o lançamento de dois aprimoramentos importantes para a experiência REST no docs.microsoft.com:
- A versão prévia do Navegador de APIs REST – Um modo fácil de pesquisar e descobrir APIs REST desenvolvidas pela Microsoft.
- REST Try It – Uma experiência interativa que permite experimentar APIs REST diretamente no navegador da Web preferencial.
Descobrir APIs REST em um local
Se você já conhece nossas experiências existentes do Navegador de API, como para .NET, PowerShell, Python ou JavaScript, você se sentirá em casa com essa nova versão. Ela permite que você receba rapidamente a documentação de uma ampla variedade de APIs REST sem precisar contar com uma experiência de pesquisa menos focada. O Navegador de API acelera seu trabalho por encontrar a API certa em segundos.
Antes, se você quisesse encontrar uma documentação específica da API REST no docs.microsoft.com, era necessário procurá-la usando a pesquisa em todo o site ou um dos componentes de navegação em páginas de conteúdo, como o sumário. Isso pode ser demorado, especificamente quando você sabe exatamente o que está procurando. Queríamos facilitar isso.
A partir de hoje, você pode descobrir as APIs REST da Microsoft de maneira muito mais eficiente, em um local centralizado: o https://docs.microsoft.com/rest/api. Basta selecionar um serviço no menu suspenso para encontrar todas as APIs de serviço disponíveis:
Precisa salvar um clique? Para algumas das APIs mais usadas, você pode contar com Filtros Rápidos. Basta clicar em um deles para abrir instantaneamente o grande conjunto de APIs de um determinado serviço, na última versão:
Projetamos a experiência de pesquisa para que seja possível encontrar as informações de API necessárias, mesmo que você não saiba as palavras-chave exatas ou não conheça o serviço em que ela está. Por padrão, vamos pesquisar em todas as APIs documentadas no docs.microsoft.com. Somente quando um serviço for selecionado, a pesquisa ocorrerá dentro do escopo desse serviço.
Precisa pesquisar várias palavras-chave ao mesmo tempo? Você também pode fazer isso!
Experimente as APIs REST do Azure em seu navegador
Encontrou uma API do Azure interessante, mas não sabe se é exatamente o que você precisa para criar o cenário? Não se preocupe, porque a partir de hoje você pode experimentar as APIs REST do Azure diretamente no navegador, no docs.microsoft.com!
Basta pressionar o botão verde Experimentar:
Depois de selecionar Experimentar em uma API REST, você acessará uma exibição focada para experimentar valores de parâmetro ou corpos da solicitação diferentes. Você pode alterar facilmente o contexto do artigo usando o menu Conteúdo no canto superior esquerdo da página:
Queremos seus comentários
Há muitos aprimoramentos que planejamos implementar em curto prazo, portanto, essa experiência não é final. Por exemplo, o botão Experimentar será habilitado não apenas para APIs REST do Azure. Queremos que você nos diga como podemos aprimorar a experiência REST. Basta abrir um novo problema e retornaremos assim que possível.
Você também pode seguir nossa conta do Twitter para as receber notificações e atualizações mais recentes.
Sonha em fazer do mundo um lugar melhor para os desenvolvedores? Junte-se à nossa equipe!