Actualizar desde el origen
Una especificación de API tiene vida propia. Volver a importar sobrescribiendo todo le haría perder sus ajustes; volver a importar al lado produciría un duplicado. Restorm hace la tercera cosa: calcula el delta.
Cómo funciona
Section titled “Cómo funciona”Cada importación con éxito guarda una huella del origen en la carpeta de variables creada. El botón Actualizar de la carpeta recupera el origen, compara las huellas y aplica las diferencias en lugar de partir de cero:
- las operaciones nuevas se añaden, en el lugar donde las habría colocado una importación nueva;
- las operaciones modificadas ven sus parámetros completados con lo que añade la especificación;
- las operaciones que la especificación marca como obsoletas se señalan y aparecen atenuadas en el árbol;
- las operaciones desaparecidas del origen se señalan como retiradas y aparecen tachadas: siguen siendo ejecutables y nunca se eliminan;
- sus modificaciones se conservan: el nombre, el método, la URL y los valores introducidos nunca se sobrescriben.
El principio: la especificación tiene autoridad sobre lo que describe, usted tiene autoridad sobre el resto.
El recorrido completo —dónde está el botón, qué muestra el asistente antes de aplicar, qué le ocurre a la documentación— se describe en Acceso y actualización de la documentación de una API importada.
Formatos resincronizables
Section titled “Formatos resincronizables”Son doce formatos:
- OpenAPI 3.x
- Swagger 2.0 (la misma página que el anterior, pero contado aparte aquí: los dos tienen su propia lógica de resincronización)
- GraphQL (SDL)
- gRPC — archivo
.protoy reflexión del servidor - SOAP / WSDL
- OData
- AsyncAPI
- Postman
- Insomnia
- Bruno
- OpenRPC
- Smithy
Formatos no resincronizables
Section titled “Formatos no resincronizables”HAR, cURL, PowerShell, REST Client, Thunder Client, Paw, HTTPie, RAML, WADL, Thrift, TypeSpec, API Blueprint, tRPC.
Para esos, una nueva importación crea un árbol nuevo: le corresponde a usted conciliar los dos, o importar en una carpeta dedicada.
Caso particular: gRPC por reflexión
Section titled “Caso particular: gRPC por reflexión”Una petición gRPC importada por reflexión tiene un botón Actualizar desde la reflexión directamente en su pestaña: es el camino más corto cuando un servicio evoluciona durante el desarrollo.