Primeiros passos
Use o Echo para preparar um pedido de API, enviá-lo e compreender a resposta. Este guia abrange Windows e macOS. Para Android e iOS, consulte Echo no telemóvel.
Instalar o Echo
No Windows, procure Gapfy Echo na Microsoft Store, instale a aplicação e abra-a pelo menu Iniciar. Num Mac com Apple silicon, descarregue o instalador, abra o ficheiro .pkg e conclua a instalação. Depois, abra o Echo em Aplicações. Esta versão destina-se a Macs com chip Apple, incluindo os modelos compatíveis de iMac; não instala uma versão para Intel.
Escolher como começar
O modo de convidado permite guardar pedidos, coleções e ambientes no computador sem criar uma conta. A base de dados é cifrada, com a chave protegida pelo Windows DPAPI ou pelo Keychain do macOS. Pode editar o trabalho guardado sem ligação. Para chamar uma API remota, continua a precisar de acesso a essa API.
Inicie sessão no navegador habitual para sincronizar trabalho, utilizar coleções partilhadas e selecionar uma organização. Confirme o espaço de trabalho ativo antes de criar conteúdo partilhado. As funções na nuvem dependem das permissões e do plano da conta. Consulte coleções e partilha.
Enviar e guardar o primeiro pedido
- Crie um espaço para o projeto e uma coleção dentro dele.
- Adicione um pedido HTTP. Escolha um nome fácil de reconhecer, como
List orders. - Escolha o método e introduza o URL da API. Preencha os parâmetros de consulta e os cabeçalhos nos editores. Para POST ou PUT, escolha o formato de corpo aceite pela API.
- Configure a autenticação do pedido quando necessário. Prefira uma variável de ambiente a um token colado no URL.
- Selecione o ambiente e envie. Pode cancelar uma execução em curso.
- Consulte o estado, os cabeçalhos e o corpo da resposta. A vista de tempos separa a ligação, a espera pelo servidor e a transferência da resposta.
- Guarde o pedido na coleção. Uma entrada no histórico não substitui um pedido guardado que pretende manter.
Comece com uma operação de leitura numa API que possa chamar em segurança. Um pedido pode criar ou alterar dados. Conheça os editores em pedidos e protocolos.
Adaptar a área de trabalho
Use a paleta de comandos para encontrar ações sem percorrer todos os menus. Abra pedidos em separadores ou organize até quatro painéis para comparar chamadas relacionadas. O histórico tem filtros para encontrar execuções anteriores e consultar os seus detalhes.
As definiçõ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 alteração de idioma o pedir. A secção de atalhos permite alterar combinações e repor as predefinições.
As preferências controlam também a recuperação dos separadores e as predefinições de novos pedidos, como tempo limite, validação de certificados e redirecionamentos. Confirme o pedido quando precisar de uma exceção. Proxy e certificados de cliente são explicados em pedidos e protocolos.
Trazer pedidos existentes
Use a secção de importação nas definições para ficheiros Postman, Insomnia, Bruno ou OpenAPI. O assistente separado de importação cURL usa IA e exige um lugar Pro AI. Leia a pré-visualização e os avisos antes de confirmar. Algumas definições e anexos precisam de ajustes manuais. Importação e exportação explica também pastas associadas e publicação de documentação.
Quando algo não funcionar
Se um pedido falhar, confirme o ambiente, o URL resolvido, a autenticação e os detalhes da resposta. Se faltar conteúdo partilhado, confirme a conta, o espaço de trabalho e o estado da sincronização. Os detalhes mostram a atividade recente e as ações para conflitos ou itens que precisam de reparação.
As definições mostram a versão instalada, ferramentas de diagnóstico e procura de atualizações quando o canal de instalação oferece essa função. Uma verificação indisponível na aplicação não significa que a instalação pela loja não tenha atualizações. Ao contactar o suporte, indique a versão e a ação que falhou e retire as credenciais dos registos partilhados.
Repor a base 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 ligação ou permissão, comece pelos detalhes do erro.