Importar uma coleção Postman
O Restorm importa as coleções Postman v2.0 e v2.1 (o formato que o “Export ▸ Collection v2.1” do Postman produz).
Importar
Section titled “Importar”Ficheiro ▸ Importar (Ctrl+I) e depois o ficheiro .json exportado.
O que é importado
Section titled “O que é importado”| Elemento Postman | O que o Restorm faz com ele |
|---|---|
Pastas (item aninhados) | Pastas, à mesma profundidade |
| Pedidos | Pedidos HTTP — ou GraphQL quando o corpo é do tipo graphql |
Corpos raw, formdata, urlencoded, file, graphql | O tipo de corpo correspondente |
| Variáveis de coleção | As variáveis de um ambiente |
| Descrições | As notas do pedido e a documentação de API |
| Respostas de exemplo | A documentação de API |
Os scripts
Section titled “Os scripts”É esta a parte que distingue esta importação. Os seus scripts de pré-pedido e de teste não se perdem: são conservados na documentação e convertidos num cenário executável cujas caixas de código executam o script tal e qual.
Para isso, o Restorm fornece uma camada de compatibilidade pm.* nas suas
ações de código JavaScript:
pm.environment, pm.variables, pm.response, pm.test, pm.expect,
pm.sendRequest, pm.setNextRequest, pm.cookies… As suas asserções continuam,
portanto, a funcionar sem reescrita.
A autenticação
Section titled “A autenticação”Os blocos de autenticação do Postman (oauth2, apikey, bearer, basic,
digest, hawk, aws, ntlm, edgegrid) são lidos e resumidos na
documentação de API, com os valores sensíveis ocultados.
Não são convertidos em credenciais executáveis: recrie uma rota de autenticação — são cinco minutos, e ganha com isso a renovação automática do token.
Atualizar
Section titled “Atualizar”O Postman faz parte dos formatos ressincronizáveis (se a coleção tiver sido importada a partir de um URL): o botão Atualizar da pasta obtém a origem e o Restorm aplica o delta. Consulte Atualizar a partir da origem.
Ir mais longe
Section titled “Ir mais longe”O guia Migrar do Postman percorre a migração completa, incluindo os ambientes e os runners.