Richiedi la convalida per REST APIs in API Gateway - Amazon API Gateway

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Richiedi la convalida per REST APIs in API Gateway

È possibile configurare API Gateway per eseguire la convalida di base di una API richiesta prima di procedere con la richiesta di integrazione. Quando la convalida fallisce, API Gateway fallisce immediatamente la richiesta, restituisce una risposta di errore 400 al chiamante e pubblica i risultati della convalida in Logs. CloudWatch Questo comportamento riduce le chiamate non necessarie al back-end. Aspetto ancora più importante, ti permette di concentrarti sulle attività di convalida specifiche dell'applicazione. È possibile convalidare il corpo di una richiesta verificando che i parametri obbligatori della richiesta siano validi e diversi da null oppure specificando uno schema di modello per una convalida dei dati più complessa.

Panoramica della convalida di base delle richieste in Gateway API

APIGateway può eseguire la convalida di base delle richieste, in modo che tu possa concentrarti sulla convalida specifica dell'app nel backend. Per la convalida, API Gateway verifica una o entrambe le seguenti condizioni:

  • I parametri di richiesta richiesti nella URI stringa di query e nelle intestazioni di una richiesta in entrata sono inclusi e non sono vuoti.

  • Il payload della richiesta applicabile aderisce alla richiesta JSONdello schema configurato del metodo.

Per attivare la convalida, si specificano le regole di convalida in un validatore di richiesta, si aggiunge il validatore alla mappa dei validatori di richiesta e si assegna il API validatore ai singoli metodi. API

Nota

La convalida del corpo della richiesta e Comportamenti passthrough di integrazione sono due argomenti separati. Quando il payload di una richiesta non dispone di uno schema di modello corrispondente, puoi scegliere di eseguire il transito o il blocco del payload originale. Per ulteriori informazioni, consulta Comportamenti passthrough di integrazione.