Echo no Android e no iOS

O Echo Mobile permite enviar requisições, conferir respostas e trabalhar com suas coleções longe do computador. Use os links da página de downloads para abrir a loja do seu dispositivo. O aplicativo móvel tem uma interface própria, por isso algumas ferramentas do desktop não têm uma tela equivalente no celular.

Comece com uma requisição

1. Abra Coleções. Crie um espaço, se ainda não tiver um, e adicione uma coleção dentro dele.
2. Abra a coleção e adicione uma requisição. As novas requisições criadas no celular começam como HTTP.
3. Dê um nome, escolha o método e informe uma URL que o dispositivo consiga acessar.
4. Use Parâmetros, Cabeçalhos, Corpo e Autenticação para completar a requisição. Você pode desativar uma linha de parâmetro ou cabeçalho sem excluí-la.
5. Toque em Enviar. Enquanto a requisição estiver rodando, o mesmo local oferece Cancelar.
6. Abra Resposta para conferir o resultado. As alterações em uma requisição editável são salvas automaticamente, sem uma etapa de salvar antes do envio.

Você pode trabalhar com os dados do dispositivo sem entrar em uma conta. Para enviar uma requisição, ainda é necessário ter acesso à API de destino. Se a API estiver rodando no computador, localhost no celular aponta para o próprio celular. Use um endereço acessível pelo dispositivo e confira a conexão de rede ou VPN.

A base de dados do dispositivo é criptografada, e sua chave fica no armazenamento seguro do sistema. Mantenha o bloqueio de tela ativado, especialmente quando as coleções contêm credenciais ou respostas privadas.

Traga suas coleções do desktop

Entre em Configurações com a mesma conta Gapfy usada no desktop. Se você participa de várias organizações, escolha o espaço de trabalho correspondente antes de procurar as coleções. Puxe a lista de coleções ou ambientes para baixo para sincronizar, ou use Sincronizar agora em Configurações.

Coleções, requisições e ambientes podem acompanhar você entre dispositivos. O histórico de requisições e os cookies ficam no dispositivo em que foram criados. Um erro de sincronização significa que as últimas alterações podem não ter chegado ao outro dispositivo. Confira o estado e entre novamente quando o aplicativo pedir.

As coleções recebidas aparecem em Compartilhado comigo, agrupadas pelo nome de quem compartilhou. O acesso de leitura permite abrir e enviar requisições sem alterar a coleção salva. Para editar, é necessário ter acesso de contribuição. Configure o compartilhamento pelo desktop ou pelo Maestro.

Escolha um ambiente

Abra Ambientes para criar um ambiente e editar suas variáveis. Salve cada variável depois de alterar o nome ou o valor. Marque senhas e tokens como Segredo para esconder os valores no editor; use Mostrar quando precisar conferir um deles.

Escolha Definir como ativo na lista ou toque no nome do ambiente ao lado de Enviar e selecione um ali. Sem ambiente limpa a seleção. Uma requisição como {{baseUrl}}/orders usa o ambiente selecionado no envio. Se uma variável não for substituída, confira primeiro o ambiente ativo e o nome da variável.

As referências do Key Vault sincronizadas pelo desktop mantêm esse tipo no celular. Salvar uma referência não a transforma em um segredo de texto comum. O aplicativo móvel não consegue buscar o segredo no Key Vault, então uma requisição que dependa dele não pode rodar ali. Use um ambiente adequado ao celular ou envie a requisição pelo desktop. Veja ambientes e variáveis.

Autenticação e detalhes da resposta

Bearer, Basic e chave de API têm campos próprios. A chave de API pode ser enviada em um cabeçalho ou parâmetro de consulta. Outros tipos de autenticação mostram a configuração em JSON e não oferecem todas as telas de configuração do desktop. Ter um tipo salvo não garante que seu fluxo interativo esteja disponível no celular.

A resposta mostra status, duração, tempo até o primeiro byte, tamanho e cabeçalhos. Você pode alternar entre o corpo com destaque de sintaxe e o texto bruto, além de copiar o corpo exibido. Corpos grandes são cortados no visualizador, e cada item do histórico guarda apenas um trecho. Uma visualização cortada não contém a resposta inteira.

Os resultados de testes existentes e as mensagens do console dos scripts aparecem junto da resposta. A interface móvel não tem editor de scripts. Prepare os scripts no desktop e sincronize a requisição antes de executá-la no celular.

O Histórico permite buscar pela URL e filtrar respostas bem-sucedidas, erros HTTP e falhas de transporte. Toque em um item para reabrir sua requisição. O dispositivo mantém até 200 execuções por requisição. A tela inicial também oferece atalhos para requisições recentes.

Protocolos e telas maiores

O motor compartilhado executa HTTP, GraphQL, WebSocket e SSE. O suporte a gRPC é parcial, com chamadas unárias e descoberta por reflexão no motor; certificados de cliente e visualização de streams têm limitações. Configurações mostra um resumo das capacidades do dispositivo.

Crie e configure requisições de protocolos avançados no desktop antes de sincronizá-las. O editor móvel não tem seletor de protocolo, navegador de serviços gRPC nem os painéis interativos de streaming do desktop. Também não tem telas para executar coleções em lote, encadear requisições, criar agendamentos ou mocks, importar e exportar ou usar assistência de IA. Use os guias do desktop para essas tarefas.

Na horizontal, em uma tela com largura suficiente, a lista de uma coleção e a requisição podem aparecer juntas. O editor também pode mostrar a resposta ao lado da requisição quando há espaço. Configurações oferece temas do sistema, claro e escuro, além de cores de destaque. A interface acompanha o idioma do dispositivo.

Resolva um problema de conexão ou sincronização

Se o Android pedir permissão de Dispositivos próximos antes de uma requisição à sua rede, permita o acesso para alcançar esse endpoint. Quando a permissão foi recusada, o aplicativo oferece um link para suas configurações no sistema. Endpoints públicos e da sua rede podem exigir acessos diferentes.

Redefinir dados locais, em Configurações, é uma ação de recuperação dos dados deste dispositivo. Ela pede confirmação e fica indisponível durante a sincronização ou a troca de espaço de trabalho. Espaços, coleções, requisições e ambientes já sincronizados podem ser baixados novamente depois da entrada na conta. Alterações ainda não sincronizadas, histórico e cookies deste dispositivo são perdidos definitivamente. Leia a confirmação com atenção antes de usar essa ação.

Use Feedback em Configurações para relatar um problema e descrever o que estava fazendo. Inclua o protocolo e o erro mostrado, removendo credenciais e dados privados da resposta.