Transformaciones al exportar
Al exportar una definición diseñada con las funciones de API Designer en un formato que no las admita, la definición se modifica para ajustarse al formato de destino. Parte de la expresividad se pierde en el proceso.
La tabla siguiente describe las modificaciones realizadas en la definición de su API al exportar en una de las siguientes especificaciones:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Función no compatible | Transformación |
|---|---|
| Componentes | El componente se copia en cada lugar donde se utiliza. |
| Rangos de respuesta y respuestas predeterminadas | Se ha eliminado la respuesta. |
| Autenticación Bearer y OpenID Connect | Se ha eliminado el esquema de seguridad. |
| Combinaciones de allOf | La combinación se reemplaza por un objeto que contiene todas las propiedades de todos los tipos utilizados. |
| Combinaciones de anyOf y oneOf | La combinación se reemplaza por un objeto vacío. |
| Múltiples puntos de conexión | El primer punto de conexión publicado se incluye en la definición; los demás se ignoran. |
OpenAPI Specification 3.0 solo admite URL en el campo Términos de servicio. Al exportar una definición en OAS 3.0, este campo se exporta solo si contiene una URL. Si no es así, el campo Términos de servicio se ignora para garantizar la validez de la definición.