Pular para o conteúdo
fetchpier.comFetchpier Docs

Visão geral da importação

O Fetchpier pode gerar uma coleção a partir de um esquema de API existente. Formatos suportados:

  • OpenAPI 3.x e Swagger 2.x, JSON ou YAML.
  • GraphQL SDL (.graphql / .gql) e JSON de introspecção do GraphQL.
  • Coleção JSON do Postman v2.x, incluindo arquivos de environment.
  • WSDL (serviços web SOAP) — apenas bindings SOAP 1.1 / WSDL 1.1. Bindings HTTP não SOAP e WSDL 2.0, incluindo serviços REST/JSON, não são suportados.

A origem do esquema pode ser um arquivo local, uma URL HTTP(S) ou texto cru colado, escolhidos por abas no assistente de importação.

Por padrão, uma importação cai na pasta atualmente selecionada na árvore de coleções — ou na pasta que contém a requisição selecionada; sem nada selecionado, cai na raiz da árvore de requisições. Essa mesma seleção determina onde as ações “New request” e “New collection” da barra de ferramentas criam.

A detecção de formato é automática a partir do conteúdo da entrada (ou você pode especificá-la manualmente). Uma vez detectado, o assistente de importação pergunta por:

  • Nome da coleção (por padrão, o título do esquema).
  • Estratégia de conflito quando a coleção de destino já existe: mesclar — adicionar as requisições do esquema, pular as que colidem de nome com uma requisição existente e deixar intactas todas as outras — ou abortar, que não faz nenhuma mudança e reporta o conflito. Não há nenhuma opção que apague a coleção existente; para começar do zero, apague a coleção você mesmo primeiro.
  • Estratégia de environment (somente Postman): criar um environment novo a partir do arquivo, mesclá-lo no ativo, ou pular.

Importações longas reportam eventos de progresso, então a UI mostra uma barra de progresso e a operação atual. O resumo do resultado lista quantas requisições, pastas e variáveis de environment foram criadas, mais quaisquer avisos por operação. A coleção gerada usa o próprio formato .http do Fetchpier, então uma vez importada é editável como qualquer coleção feita à mão.

A primeira importação de esquema de cada sessão leva um pouco mais (~200–300 ms) enquanto os módulos do importador carregam sob demanda; as seguintes na mesma sessão são imediatas.

Guias por formato: OpenAPI / Swagger, GraphQL, WSDL, Postman.