Guias
Migrar coleções do Postman para o Endvia
Como levar coleções, ambientes e o backup de dados do Postman para o Endvia; valores secretos, testes e armazenamento em uma pasta.
O Endvia trabalha diretamente com arquivos do Postman: as coleções são importadas, editadas e salvas de novo no formato do Postman. Não há conta nem servidor de sincronização.
O que pode ser migrado?
- Arquivos Postman Collection v2.0 e v2.1; pastas, configurações de autenticação, variáveis, scripts e descrições são preservados.
- Arquivos de ambiente e de variáveis globais.
- Backup de dados do Postman (.zip): todas as coleções e ambientes em um único arquivo.
Passos
- No Postman, exporte como arquivos a coleção e os ambientes que ela usa, ou solicite o backup de dados da sua conta.
- No Endvia, selecione os arquivos com Arquivo › Importar (Ctrl/⌘ O). Os arquivos são processados neste dispositivo.
- A janela que se abre lista os itens reconhecidos: para coleções, a quantidade de requisições e de respostas de exemplo; para ambientes, a quantidade de variáveis. Se houver avisos, eles também aparecem aqui.
- Confira a lista e clique no botão de importação (por exemplo, Importar 3 itens).
- Em Requisição › Gerenciar ambientes (Ctrl/⌘ E), escolha o ambiente que será usado com o botão Ativar.
- Abra uma requisição e teste-a com Enviar (Ctrl/⌘ ↵). Os resultados dos testes aparecem na seção Testes da resposta.
- Para executar a coleção inteira em sequência, abra Exibir › Executor.
O que significam os avisos?
A janela de importação informa com antecedência o que o Endvia não consegue executar no arquivo ou o que está faltando nele:
- Variáveis secretas: variáveis secretas cujo valor não está no arquivo precisam ser digitadas de novo no ambiente.
- pm.sendRequest e require: os scripts são executados em um ambiente sem acesso à rede, por no máximo 5 segundos. As linhas com essas chamadas geram erro. São suportados pm.test, pm.expect, pm.environment e pm.response.
- Campos de formulário que esperam arquivos: os arquivos não fazem parte da coleção; precisam ser selecionados de novo.
Guardar em uma pasta
No Chrome, no Edge e no Opera, Arquivo › Conectar a uma pasta mantém as coleções como arquivos do Postman na pasta escolhida. A pasta pode ser um repositório git ou uma unidade compartilhada. Valores bloqueados (secretos) não são gravados nesses arquivos nem nas exportações. A coleção aberta também pode ser salva sozinha como arquivo do Postman com o comando Arquivo › Exportar: (nome da coleção).
Diferença entre navegador e desktop
Na versão para navegador, as requisições são enviadas segundo as regras do navegador: se o servidor não permitir (CORS), a resposta não pode ser lida, e alguns cabeçalhos são definidos pelo navegador. Para enviar requisições sem essa restrição, é preciso o aplicativo para desktop, que está em preparação. gRPC, MQTT e Socket.IO não são suportados.
O Endvia abre na hora no navegador.