Trasformazione delle richieste in entrata e delle risposte in uscita
Scopri come modificare le richieste in entrata e le risposte in uscita inviate ai e dai servizi backend con il gateway API.
Spesso si verificano situazioni in cui si desidera che un gateway API modifichi le richieste in entrata prima di inviarle ai servizi backend. Analogamente, potrebbe essere necessario che il gateway API modifichi le risposte restituite dai servizi backend. Ad esempio:
- I servizi backend possono richiedere che le richieste includano un determinato set di intestazioni HTTP, ad esempio Accept-Language e Accept-Encoding. Per nascondere questi dettagli di implementazione ai consumer API e ai client API, è possibile utilizzare il gateway API per aggiungere le intestazioni richieste.
- I server Web spesso includono informazioni complete sulla versione nelle intestazioni delle risposte. Per motivi di sicurezza, potresti voler impedire ai consumer API e ai client API di conoscere lo stack tecnologico sottostante. È possibile utilizzare il gateway API per rimuovere le intestazioni del server dalle risposte.
- I servizi backend possono includere informazioni riservate in una risposta. È possibile utilizzare il gateway API per rimuovere tali informazioni.
Utilizzando un gateway API, puoi:
- Aggiungere, rimuovere e modificare le intestazioni nelle richieste e nelle risposte.
- Aggiungere, rimuovere e modificare i parametri di query nelle richieste.
- Riscrivere gli URL delle richieste da un formato pubblico a un formato interno, forse per supportare applicazioni e migrazioni legacy.
I criteri di richiesta e risposta vengono utilizzati per trasformare le intestazioni e i parametri di query delle richieste in entrata e le intestazioni delle risposte in uscita (vedere Aggiunta di criteri di richiesta e criteri di risposta alle specifiche di distribuzione API).
È possibile includere variabili di contesto nei criteri di richiesta e risposta di trasformazione dei parametri di intestazione e query. L'inclusione delle variabili di contesto consente di modificare le intestazioni e i parametri di query con i valori di altre intestazioni, parametri di query, parametri di percorso e parametri di autenticazione. Tenere presente che i valori delle variabili di contesto vengono estratti dalla richiesta o dalla risposta originale e non vengono successivamente aggiornati poiché un gateway API utilizza un criterio di trasformazione per valutare una richiesta o una risposta. Per ulteriori informazioni sulle variabili di contesto, vedere Aggiunta di variabili di contesto a criteri e definizioni backend HTTP.
Se una richiesta di trasformazione di un parametro di intestazione o di query o un criterio di risposta genererà un'intestazione o un parametro di query non valido, il criterio di trasformazione verrà ignorato.
Tenere presente che non è possibile utilizzare i criteri di trasformazione dell'intestazione per trasformare determinate intestazioni di richiesta e risposta protette. Vedere Intestazioni richiesta protette e intestazioni risposta.
È possibile aggiungere criteri di richiesta e risposta di trasformazione dei parametri di intestazione e query a una specifica di distribuzione API effettuando le operazioni riportate di seguito.
- utilizzo di Console
- modifica di un file JSON
Contenuto: