Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Minta validasi untuk REST APIs di API Gateway
<a name="api-gateway-method-request-validation"></a>

 Anda dapat mengonfigurasi API Gateway untuk melakukan validasi dasar permintaan API sebelum melanjutkan dengan permintaan integrasi. Ketika validasi gagal, API Gateway segera gagal permintaan, mengembalikan respons kesalahan 400 ke pemanggil, dan menerbitkan hasil validasi di Log. CloudWatch Ini mengurangi panggilan yang tidak perlu ke backend. Lebih penting lagi, ini memungkinkan Anda fokus pada upaya validasi khusus untuk aplikasi Anda. Anda dapat memvalidasi badan permintaan dengan memverifikasi bahwa parameter permintaan yang diperlukan valid dan non-null atau dengan menentukan skema model untuk validasi data yang lebih rumit.

**Topics**
+ [Ikhtisar validasi permintaan dasar di API Gateway](#api-gateway-request-validation-basic-definitions)
+ [Model data untuk REST APIs](models-mappings-models.md)
+ [Siapkan validasi permintaan dasar di API Gateway](api-gateway-request-validation-set-up.md)
+ [AWS CloudFormation template API sampel dengan validasi permintaan dasar](api-gateway-request-validation-sample-cloudformation.md)

## Ikhtisar validasi permintaan dasar di API Gateway
<a name="api-gateway-request-validation-basic-definitions"></a>

 API Gateway dapat melakukan validasi permintaan dasar, sehingga Anda dapat fokus pada validasi khusus aplikasi di backend. Untuk validasi, API Gateway memverifikasi salah satu atau kedua kondisi berikut: 
+ Parameter permintaan yang diperlukan dalam URI, string kueri, dan header permintaan masuk disertakan dan tidak kosong. API Gateway hanya memeriksa keberadaan parameter dan tidak memeriksa jenis atau formatnya.
+  Payload permintaan yang berlaku mematuhi permintaan [skema JSON](https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04) yang dikonfigurasi dari metode untuk jenis konten tertentu. Jika tidak ada jenis konten yang cocok ditemukan, validasi permintaan tidak dilakukan. Untuk menggunakan model yang sama terlepas dari jenis konten, setel tipe konten untuk model data Anda`$default`.

Untuk mengaktifkan validasi, Anda menentukan aturan validasi dalam validator [permintaan, menambahkan validator](https://docs.aws.amazon.com/apigateway/latest/api/API_RequestValidator.html) ke [peta API validator permintaan, dan menetapkan validator](https://docs.aws.amazon.com/apigateway/latest/api/API_RequestValidator.html) ke metode API individual. 

**catatan**  
Minta validasi badan dan [Perilaku permintaan metode untuk muatan tanpa memetakan template untuk REST APIs di API Gateway](integration-passthrough-behaviors.md) merupakan dua topik terpisah. Jika payload permintaan tidak memiliki skema model yang cocok, Anda dapat memilih untuk melewati atau memblokir muatan asli. Untuk informasi selengkapnya, lihat [Perilaku permintaan metode untuk muatan tanpa memetakan template untuk REST APIs di API Gateway](integration-passthrough-behaviors.md).