Trasformazioni all'esportazione
Quando si esporta una definizione progettata con le funzionalità di API Designer in un formato che non le supporta, la definizione viene modificata per adattarsi al formato di destinazione. Nel processo si perde una certa espressività.
La tabella seguente descrive le modifiche apportate alla definizione dell'API durante l'esportazione in una delle seguenti specifiche:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Funzionalità non supportata | Trasformazione |
|---|---|
| Componenti | Il componente viene copiato in ogni punto in cui viene utilizzato. |
| Intervalli di risposta e risposte predefinite | La risposta viene rimossa. |
| Autenticazione Bearer e OpenID Connect | Lo schema di sicurezza viene rimosso. |
| Combinazioni allOf | La combinazione viene sostituita con un oggetto contenente tutte le proprietà di tutti i tipi utilizzati. |
| Combinazioni anyOf e oneOf | La combinazione viene sostituita con un oggetto vuoto. |
| Endpoint multipli | Il primo endpoint pubblicato viene incluso nella definizione, gli altri vengono ignorati. |
OpenAPI Specification 3.0 supporta solo gli URL nel campo Termini di servizio. Quando si esporta una definizione in OAS 3.0, questo campo viene esportato solo se contiene un URL. In caso contrario, il campo Termini di servizio viene ignorato per garantire la validità della definizione.