Visión general de la importación

Fetchpier puede generar una colección desde un esquema de API existente. Formatos soportados:

• OpenAPI 3.x y Swagger 2.x, JSON o YAML.
• GraphQL SDL (.graphql / .gql) y JSON de introspección de GraphQL.
• Colección JSON de Postman v2.x, incluyendo archivos de environment.
• WSDL (servicios web SOAP) — solo bindings SOAP 1.1 / WSDL 1.1. Los bindings HTTP no SOAP y WSDL 2.0, incluidos los servicios REST/JSON, no están soportados.

El origen del esquema puede ser un archivo local, una URL HTTP(S) o texto crudo pegado, que se eligen con pestañas en el asistente de importación.

Por default, una importación cae en la carpeta seleccionada actualmente en el árbol de colecciones —o en la carpeta que contiene la solicitud seleccionada; sin nada seleccionado, cae en la raíz del árbol de solicitudes. Esa misma selección determina dónde crean las acciones “New request” y “New collection” de la barra de herramientas.

La detección de formato es automática a partir del contenido de la entrada (o podés especificarla a mano). Una vez detectado, el asistente de importación pregunta por:

• Nombre de la colección (por default, el título del esquema).
• Estrategia de conflicto cuando la colección destino ya existe: fusionar —agregar las solicitudes del esquema, saltear las que colisionen de nombre con una solicitud existente y dejar intactas todas las demás— o abortar, que no hace ningún cambio y reporta el conflicto. No hay ninguna opción que elimine la colección existente; para arrancar de cero, eliminá la colección vos primero.
• Estrategia de environment (solo Postman): crear un environment nuevo desde el archivo, fusionarlo con el activo, o saltearlo.

Las importaciones largas reportan eventos de progreso, así la UI muestra una barra de progreso y la operación actual. El resumen del resultado lista cuántas solicitudes, carpetas y variables de environment se crearon, más cualquier warning por operación. La colección generada usa el propio formato .http de Fetchpier, así que una vez importada se edita como cualquier colección hecha a mano.

La primera importación de esquema de cada sesión tarda un poco más (~200–300 ms) mientras los módulos del importador se cargan a demanda; las siguientes en la misma sesión son inmediatas.

Guías por formato: OpenAPI / Swagger, GraphQL, WSDL, Postman.