Primeiros passos
Use o Echo para preparar uma requisição de API, enviá-la e entender a resposta. Este guia cobre Windows e macOS. Para Android e iOS, comece por Echo no celular.
Instale o Echo
No Windows, procure Gapfy Echo na Microsoft Store, instale o aplicativo e abra pelo menu Iniciar. Em um Mac com Apple silicon, baixe o instalador, abra o arquivo .pkg e conclua a instalação. Depois, abra o Echo em Aplicativos. Esse download atende Macs com chip Apple, incluindo os modelos compatíveis de iMac; ele não instala uma versão para Intel.
Escolha como começar
O modo de convidado permite salvar requisições, coleções e ambientes no computador sem criar uma conta. O banco de dados é criptografado, com a chave protegida pelo Windows DPAPI ou pelo Keychain do macOS. Você pode editar o trabalho salvo sem conexão. Para chamar uma API remota, ainda precisa ter acesso a ela.
Entre na conta pelo navegador habitual para sincronizar o trabalho, usar coleções compartilhadas e selecionar uma organização. Confira o espaço de trabalho ativo antes de criar conteúdo compartilhado. As funções na nuvem dependem das permissões e do plano da conta. Consulte coleções e compartilhamento.
Envie e salve a primeira requisição
- Crie um espaço para o projeto e uma coleção dentro dele.
- Adicione uma requisição HTTP. Dê um nome fácil de reconhecer, como
List orders. - Escolha o método e informe a URL da API. Preencha os parâmetros de consulta e os cabeçalhos nos editores. Para POST ou PUT, escolha o formato de corpo aceito pela API.
- Configure a autenticação da requisição quando necessário. Prefira uma variável de ambiente a um token colado na URL.
- Selecione o ambiente e envie. Você pode cancelar uma execução em andamento.
- Confira o status, os cabeçalhos e o corpo da resposta. A visualização dos tempos separa a conexão, a espera pelo servidor e a transferência da resposta.
- Salve a requisição na coleção. Uma entrada no histórico não substitui uma requisição salva que você pretende manter.
Comece com uma operação de leitura em uma API que você possa chamar com segurança. Uma requisição pode criar ou alterar dados. Conheça os editores em requisições e protocolos.
Ajuste sua área de trabalho
Use a paleta de comandos para encontrar ações sem percorrer todos os menus. Abra requisições em abas ou organize até quatro painéis para comparar chamadas relacionadas. O histórico tem filtros para encontrar execuções anteriores e consultar seus detalhes.
As configurações oferecem temas claro, escuro e do sistema, cores de destaque e sete idiomas de interface. O website tem seis idiomas. Reinicie o Echo quando a mudança de idioma pedir. A seção de atalhos permite alterar combinações e restaurar os padrões.
As preferências também controlam a restauração das abas e os padrões de novas requisições, como tempo limite, validação de certificado e redirecionamentos. Confira a requisição quando precisar de uma exceção. Proxy e certificados de cliente são explicados em requisições e protocolos.
Traga suas requisições
Use a seção de importação nas configurações para arquivos do Postman, Insomnia, Bruno ou OpenAPI. O assistente separado de importação cURL usa IA e exige uma licença Pro AI. Leia a prévia e os avisos antes de confirmar. Algumas configurações e anexos precisam de ajuste manual. Importação e exportação também explica pastas vinculadas e publicação de documentação.
Quando algo não funcionar
Se uma requisição falhar, confira o ambiente, a URL resolvida, a autenticação e os detalhes da resposta. Se faltar conteúdo compartilhado, confira a conta, o espaço de trabalho e o estado da sincronização. Seus detalhes mostram a atividade recente e as ações para conflitos ou itens que precisam de reparo.
As configurações mostram a versão instalada, ferramentas de diagnóstico e verificação de atualizações quando o canal de instalação oferece esse recurso. Uma verificação indisponível no aplicativo não significa que a instalação pela loja esteja sem atualizações. Ao procurar o suporte, informe a versão e a ação que falhou, removendo credenciais dos logs compartilhados.
Redefinir o banco de dados do dispositivo remove dados desse dispositivo. Exporte o que ainda não foi sincronizado antes de considerar essa ação de recuperação. Para erros comuns de conexão ou permissão, comece pelos detalhes do erro.