Echo no Android e no iOS

O Echo Mobile permite enviar pedidos, consultar respostas e trabalhar com as suas coleções longe do computador. Use as ligações da página de downloads para abrir a loja do dispositivo. A aplicação móvel tem uma interface própria, pelo que algumas ferramentas do desktop não têm um ecrã equivalente no telemóvel.

Comece com um pedido

1. Abra Coleções. Crie um espaço, caso ainda não tenha um, e adicione uma coleção dentro dele.
2. Abra a coleção e adicione um pedido. Os novos pedidos criados no telemóvel começam como HTTP.
3. Dê-lhe um nome, escolha o método e indique um URL acessível a partir do dispositivo.
4. Use Parâmetros, Cabeçalhos, Corpo e Autenticação para completar o pedido. Pode desativar uma linha de parâmetro ou cabeçalho sem a eliminar.
5. Toque em Enviar. Durante a execução, a mesma área apresenta Cancelar.
6. Abra Resposta para consultar o resultado. As alterações a um pedido editável são guardadas automaticamente, sem ser necessário guardar antes do envio.

Pode trabalhar com os dados do dispositivo sem iniciar sessão. O envio de um pedido continua a exigir acesso à API de destino. Se a API estiver a funcionar no computador, localhost no telemóvel aponta para o próprio telemóvel. Use um endereço acessível a partir do dispositivo e confirme a ligação de rede ou VPN.

A base de dados do dispositivo é cifrada, e a sua chave fica no armazenamento seguro do sistema. Mantenha o bloqueio de ecrã ativo, sobretudo quando as coleções contêm credenciais ou respostas privadas.

Traga as coleções do desktop

Inicie sessão nas Definições com a mesma conta Gapfy usada no desktop. Se pertencer a várias organizações, selecione 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 nas Definições.

Coleções, pedidos e ambientes podem acompanhá-lo entre dispositivos. O histórico de pedidos e os cookies ficam no dispositivo onde foram criados. Um erro de sincronização significa que as alterações mais recentes podem ainda não ter chegado ao outro dispositivo. Consulte o estado e volte a iniciar sessão quando a aplicação o solicitar.

As coleções recebidas aparecem em Partilhado comigo, agrupadas pelo nome de quem as partilhou. O acesso de leitura permite abrir e enviar pedidos sem alterar a coleção guardada. Para editar, é necessário acesso de contribuição. Configure a partilha pelo desktop ou pelo Maestro.

Escolha um ambiente

Abra Ambientes para criar um ambiente e editar as suas variáveis. Guarde cada variável depois de alterar o nome ou o valor. Marque palavras-passe e tokens como Segredo para ocultar os valores no editor; use Mostrar quando precisar de os consultar.

Escolha Definir como ativo na lista ou toque no nome do ambiente junto de Enviar e selecione um nessa área. Sem ambiente limpa a seleção. Um pedido como {{baseUrl}}/orders usa o ambiente selecionado no momento do envio. Se uma variável não for substituída, confirme primeiro o ambiente ativo e o nome da variável.

As referências do Key Vault sincronizadas a partir do desktop mantêm esse tipo no telemóvel. Guardar uma referência não a transforma num segredo de texto comum. A aplicação móvel não consegue obter o segredo no Key Vault, pelo que um pedido que dependa dele não pode ser executado aí. Use um ambiente adequado ao telemóvel ou envie o pedido no desktop. Consulte 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 num cabeçalho ou parâmetro de consulta. Outros tipos de autenticação apresentam a configuração em JSON e não oferecem todos os ecrãs de configuração do desktop. Ter um tipo guardado não garante que o respetivo fluxo interativo esteja disponível no telemóvel.

A resposta apresenta estado, duração, tempo até ao primeiro byte, tamanho e cabeçalhos. Pode alternar entre o corpo com destaque de sintaxe e o texto bruto, bem como copiar o corpo apresentado. Corpos grandes são truncados no visualizador, e cada entrada do histórico guarda apenas um excerto. Uma visualização truncada não contém a resposta completa.

Os resultados de testes existentes e as mensagens da consola dos scripts aparecem junto da resposta. A interface móvel não tem editor de scripts. Prepare os scripts no desktop e sincronize o pedido antes de o executar no telemóvel.

O Histórico permite pesquisar pelo URL e filtrar respostas bem-sucedidas, erros HTTP e falhas de transporte. Toque numa entrada para reabrir o respetivo pedido. O dispositivo mantém até 200 execuções por pedido. O ecrã inicial também oferece atalhos para pedidos recentes.

Protocolos e ecrãs maiores

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

Crie e configure pedidos de protocolos avançados no desktop antes de os sincronizar. 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 ecrãs para executar coleções em lote, encadear pedidos, criar agendamentos ou mocks, importar e exportar ou usar assistência de IA. Use os guias do desktop para essas tarefas.

Na horizontal, num ecrã suficientemente largo, a lista de uma coleção e o pedido podem aparecer em conjunto. O editor também pode apresentar a resposta ao lado do pedido quando existe espaço. As Definições oferecem temas do sistema, claro e escuro, além de cores de destaque. A interface acompanha o idioma do dispositivo.

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

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

Repor dados locais, nas Definições, é uma ação de recuperação dos dados deste dispositivo. Pede confirmação e fica indisponível durante a sincronização ou a mudança de espaço de trabalho. Espaços, coleções, pedidos e ambientes já sincronizados podem ser transferidos novamente após iniciar sessão. Alterações ainda não sincronizadas, histórico e cookies deste dispositivo perdem-se definitivamente. Leia a confirmação com atenção antes de usar esta ação.

Use Feedback nas Definições para comunicar um problema e descrever o que estava a fazer. Inclua o protocolo e o erro apresentado, removendo credenciais e dados privados da resposta.