Coleções e compartilhamento com a equipe
As requisições só são úteis se você conseguir encontrá-las de novo. O Echo organiza o trabalho em espaços e coleções e permite compartilhar essa estrutura com a equipe nos seus termos.
Organize seu trabalho
Os espaços são o nível superior: use um por projeto, produto ou cliente. Dentro deles, as coleções guardam requisições e pastas aninhadas. Um espaço criado no desktop é pessoal e pertence a você dentro da organização selecionada. A propriedade e o acesso de uma equipe são gerenciados separadamente; dar o nome de uma equipe ao espaço não o transforma em um espaço de equipe. Confira na conta os limites do plano ativo.
Manter tudo organizado é simples:
- Busque pelo nome na barra lateral. As pastas que contêm resultados continuam visíveis para mostrar onde cada item está.
- Renomeie pelo menu do item ou na própria árvore. Arraste requisições entre coleções e mova pastas dentro de um espaço ou entre espaços aos quais você tem acesso.
- Escolha a ordem alfabética ou volte à ordem padrão salva. A ordenação muda a apresentação da árvore.
- Duplique uma requisição para experimentar uma variação sem alterar a original. A duplicação copia requisições, não espaços inteiros nem árvores de coleções.
- Ative o modo de seleção para marcar vários itens. Selecionar todos os visíveis respeita a busca atual. Use a barra da seleção para mover, excluir ou exportar; a duplicação em lote se aplica às requisições selecionadas.
Excluir uma coleção ou espaço também exclui seu conteúdo. Leia a confirmação, especialmente depois de selecionar uma pasta e seus itens. A seleção da pasta já inclui os descendentes.
Novas abas HTTP ou gRPC podem começar como rascunhos. Salve o rascunho em uma coleção quando quiser reutilizá-lo. Requisição rápida cria uma requisição salva na coleção Quick do espaço Personal, criando esses agrupamentos se necessário. Veja o fluxo do primeiro envio em primeiros passos.
Compartilhe com a equipe
Entre na conta, escolha o espaço de trabalho correto e sincronize a coleção primeiro. Como proprietário, abra Compartilhar no menu da coleção, busque uma pessoa da organização, escolha o nível de acesso e adicione-a. O mesmo diálogo lista as permissões existentes para alterar um nível ou revogar o acesso. Mudanças de compartilhamento precisam de conexão e podem falhar mesmo quando salvar uma requisição no dispositivo funciona.
Cada compartilhamento tem um nível de permissão:
| Nível | Uso em uma coleção pessoal compartilhada |
|---|---|
| Leitura | Abrir e enviar requisições sem alterar a coleção salva. |
| Contribuição | Adicionar e editar requisições. |
| Acesso total | Adicionar, editar e excluir requisições. |
Acesso total não transfere a propriedade. No desktop, gerenciar a própria coleção, incluindo nome, estrutura e compartilhamento, continua dependendo da propriedade. Os agrupamentos recebidos por compartilhamento não servem como destino livre para mover itens ou criar pastas. Coleções de equipe recebidas nesses agrupamentos ficam em somente leitura, mesmo quando há um nível maior registrado em outro contexto.
Quem recebe encontra as coleções em Compartilhado comigo, agrupadas por quem compartilhou. Sincronize depois de mudanças de acesso. Se a edição ficar indisponível, confira a permissão atual e o espaço de trabalho. Compartilhar uma requisição também não concede acesso à API de destino, que continua validando suas próprias credenciais.
Trabalhe em várias organizações
Se você pertence a mais de uma organização, o seletor de espaço de trabalho permite alternar entre elas sem sair e entrar novamente na conta. Cada espaço de trabalho mantém seus espaços, coleções e compartilhamentos. Escolha o mesmo espaço de trabalho no Echo e no Maestro ao trabalhar com mocks sincronizados, contratos e aplicações.
Sincronize entre dispositivos
O trabalho da sua conta é sincronizado pelo serviço da Gapfy: espaços, coleções, requisições, ambientes, agendamentos, servidores de mock e exclusões. Se você excluir uma coleção no desktop, essa exclusão será sincronizada com os outros dispositivos. Histórico de requisições e cookies ficam no dispositivo. Um agendamento ou mock sincronizado não está necessariamente rodando no servidor; isso depende do modo de execução ou hospedagem escolhido.
Use Sincronizar agora para enviar mudanças pendentes e buscar atualizações. A barra de estado e o log de sincronização do Inspector ajudam a distinguir um ciclo concluído de falta de conexão, necessidade de entrar na conta ou falha parcial. Se um limite do plano recusar uma alteração, o item pendente permanece no dispositivo. Resolva o limite e tente novamente antes de contar com essa alteração no dispositivo dos colegas.
Os aplicativos para Android e iOS compartilham o mecanismo de sincronização. As coleções da sua conta podem acompanhar você entre o desktop e o celular sem uma exportação separada para cada dispositivo. Os editores e as ferramentas disponíveis são diferentes; consulte o guia móvel.
Revise atividades e conflitos
Atividades ajuda a encontrar mudanças registradas, como criação, renomeação e exclusão de itens. Filtre por ação, tipo de item, data ou texto, aplique os filtros e abra o contexto de um registro para voltar ao item correspondente.
Quando dispositivos alteram o mesmo item, a sincronização pode escolher uma versão automaticamente pelas regras de data de atualização. Os conflitos registrados permitem revisar essas decisões depois. A presença de um conflito não significa que a sincronização sempre parou antes de substituir um valor.
- Abra Conflitos e filtre por tipo de item, resolução, data ou texto.
- Expanda um registro para comparar as versões capturadas do dispositivo e do servidor.
- Use Reconhecer se o resultado atual estiver correto. Essa ação registra a revisão, sem restaurar dados.
- Escolha Manter remoto para restaurar a versão capturada do servidor. Leia a confirmação, pois isso altera o item no dispositivo e o coloca na fila de sincronização.
- Escolha Fundir quando precisar de campos das duas versões. Selecione o valor do dispositivo ou do servidor para cada campo diferente, ou use as ações para todos os campos, e aplique o resultado.
Você pode incluir os registros já revisados na lista posteriormente. A restauração e a mesclagem dependem das versões registradas estarem disponíveis e de o item ainda existir.
Repare itens ausentes no servidor
O diálogo de problemas de sincronização agrupa itens do dispositivo cujo correspondente no servidor, ou sua pasta, não foi encontrado. Confira o nome e o conteúdo do grupo. Restaurar envia o grupo novamente para recriá-lo no servidor. Excluir cópia local remove o grupo deste dispositivo após confirmação. Isso pode incluir coleções e requisições aninhadas.
Escolha conforme a cópia que deseja manter. Restaurar pode trazer de volta algo que outra pessoa excluiu de propósito; excluir a cópia do dispositivo descarta o trabalho ainda não sincronizado. Depois do reparo, aguarde a próxima sincronização e confira o resultado. Esse reparo é separado da escolha de campos em um conflito registrado.
Compartilhe um mock que possa ser chamado
Compartilhar uma coleção dá aos colegas acesso ao seu trabalho organizado. Para dar um endpoint HTTP a uma aplicação, publique um mock sincronizado no painel de hospedagem pública do Maestro. Criar e executar mocks no desktop faz parte de todos os planos do Echo, incluindo o Free; publicar no serviço público faz parte do Echo Pro e Pro AI e, em um espaço de equipe, também exige a permissão Echo/ManageHosting. O guia de hospedagem pública de mocks explica as URLs públicas e os controles de hospedagem.
Para acesso automatizado à publicação de contratos, aos contratos vinculados ou ao feed de regras .NET, use aplicações e chaves. Criar uma chave exige Echo Pro ou Pro AI, mesmo quando os contratos que você vai consultar são gratuitos. As permissões das coleções e os escopos das chaves de aplicação têm objetivos diferentes. Compartilhar uma coleção não emite uma chave.
Modo de convidado e trabalho local
Organizar requisições, espaços e pastas e usar operações em lote também funciona em modo de convidado, totalmente offline. Compartilhamento, sincronização e espaços de trabalho precisam de uma conta conectada. Consulte primeiros passos para conhecer a diferença entre os dois modos.