Subir y actualizar una spec OpenAPI
Una simulación sirve tu propia API desde su spec OpenAPI. Funcionan YAML y JSON, OpenAPI 3.0 y 3.1. Swagger 2.0 no está soportado; conviértelo antes a OpenAPI 3. Las specs con referencias circulares no son problema: la generación detecta el ciclo y lo maneja.
Subir una spec
En la simulación, abre Endpoints, haz clic en Agregar y elige Spec de OpenAPI. Suelta el archivo o búscalo, y después elige la ruta de montaje; el diálogo muestra la URL en la que va a responder tu spec.
Haz clic en Agregar spec y después despliega para ponerla en marcha.
El límite de tamaño
Un archivo de spec puede pesar hasta 4 MB. Es un límite blando: si tu spec es más grande, divídela en varias, o escríbenos y lo podemos subir para tu organización.
Las simulaciones codegen no tienen límite de subida, porque no hay subida: el código se genera desde tu spec dentro de tu repositorio, y la spec nunca llega hasta nosotros.
Consulta Simulaciones codegen.
Specs grandes
Una spec grande pesa más al servir: usa más memoria y arranca más lento que una chica.
Ayudan dos opciones por servicio, en Configuración del servicio, pestaña Opciones de la spec:
- Cargar operaciones bajo demanda analiza cada operación en su primera solicitud en lugar de todas al arrancar. Acelera el arranque de las specs grandes.
- Simplificar el esquema recorta los esquemas desmedidos (ramas anyOf/oneOf/allOf de más) para que las specs muy grandes sigan siendo manejables.
Reemplazar una spec después
Tu API cambia; el mock la sigue reemplazando el archivo. En Configuración del servicio, elige el servicio, abre el menú de la esquina y elige Reemplazar archivo. La ruta de montaje se mantiene, y las selecciones de endpoints quedan igual donde las rutas coinciden, así que lo que apagaste sigue apagado.
Despliega otra vez para entregar la versión nueva.