Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Konversi jenis konten di API Gateway
Kombinasi API milik AndabinaryMediaTypes
, header dalam permintaan klien, dan contentHandling
properti integrasi menentukan cara API Gateway mengkodekan muatan.
Tabel berikut menunjukkan cara API Gateway mengonversi payload permintaan untuk konfigurasi spesifik Content-Type
header permintaan, binaryMediaTypes
daftar RestApisumber daya, dan nilai contentHandling
properti sumber daya Integrasi.
Metode permintaan payload | Permintaan Content-Type header |
binaryMediaTypes |
contentHandling |
Muatan permintaan integrasi |
---|---|---|---|---|
Data teks | Tipe data apa pun | Tidak terdefinisi | Tidak terdefinisi | UTF8-string yang dikodekan |
Data teks | Tipe data apa pun | Tidak terdefinisi | CONVERT_TO_BINARY |
Gumpalan biner yang didekode Base64 |
Data teks | Tipe data apa pun | Tidak terdefinisi | CONVERT_TO_TEXT |
UTF8-string yang dikodekan |
Data teks | Tipe data teks | Set dengan jenis media yang cocok | Tidak terdefinisi | Data teks |
Data teks | Tipe data teks | Set dengan jenis media yang cocok | CONVERT_TO_BINARY |
Gumpalan biner yang didekode Base64 |
Data teks | Tipe data teks | Set dengan jenis media yang cocok | CONVERT_TO_TEXT |
Data teks |
Data biner | Tipe data biner | Set dengan jenis media yang cocok | Tidak terdefinisi | Data biner |
Data biner | Tipe data biner | Set dengan jenis media yang cocok | CONVERT_TO_BINARY |
Data biner |
Data biner | Tipe data biner | Set dengan jenis media yang cocok | CONVERT_TO_TEXT |
String yang dikodekan Base64 |
Tabel berikut menunjukkan cara API Gateway mengonversi payload respons untuk konfigurasi spesifik Accept
header permintaan, binaryMediaTypes
daftar RestApisumber daya, dan nilai contentHandling
properti sumber daya. IntegrationResponse
penting
Saat permintaan berisi beberapa jenis media di Accept
tajuknya, API Gateway hanya menghormati jenis Accept
media pertama. Jika Anda tidak dapat mengontrol urutan jenis Accept
media dan jenis media konten biner Anda bukan yang pertama dalam daftar, tambahkan jenis Accept
media pertama dalam binaryMediaTypes
daftar AndaAPI. APIGateway menangani semua jenis konten dalam daftar ini sebagai biner.
Misalnya, untuk mengirim JPEG file menggunakan <img>
elemen di browser, browser mungkin mengirim Accept:image/webp,image/*,*/*;q=0.8
permintaan. Dengan menambahkan image/webp
ke binaryMediaTypes
daftar, titik akhir menerima JPEG file sebagai biner.
Payload respons integrasi | Permintaan Accept header |
binaryMediaTypes |
contentHandling |
Metode respon payload |
---|---|---|---|---|
Teks atau data biner | Tipe teks | Tidak terdefinisi | Tidak terdefinisi | UTF8-string yang dikodekan |
Teks atau data biner | Tipe teks | Tidak terdefinisi | CONVERT_TO_BINARY |
Gumpalan yang didekodekan Base64 |
Teks atau data biner | Tipe teks | Tidak terdefinisi | CONVERT_TO_TEXT |
UTF8-string yang dikodekan |
Data teks | Tipe teks | Set dengan jenis media yang cocok | Tidak terdefinisi | Data teks |
Data teks | Tipe teks | Set dengan jenis media yang cocok | CONVERT_TO_BINARY |
Gumpalan yang didekodekan Base64 |
Data teks | Tipe teks | Set dengan jenis media yang cocok | CONVERT_TO_TEXT |
UTF8-string yang dikodekan |
Data teks | Tipe biner | Set dengan jenis media yang cocok | Tidak terdefinisi | Gumpalan yang didekodekan Base64 |
Data teks | Tipe biner | Set dengan jenis media yang cocok | CONVERT_TO_BINARY |
Gumpalan yang didekodekan Base64 |
Data teks | Tipe biner | Set dengan jenis media yang cocok | CONVERT_TO_TEXT |
UTF8-string yang dikodekan |
Data biner | Tipe teks | Set dengan jenis media yang cocok | Tidak terdefinisi | String yang dikodekan Base64 |
Data biner | Tipe teks | Set dengan jenis media yang cocok | CONVERT_TO_BINARY |
Data biner |
Data biner | Tipe teks | Set dengan jenis media yang cocok | CONVERT_TO_TEXT |
String yang dikodekan Base64 |
Data biner | Tipe biner | Set dengan jenis media yang cocok | Tidak terdefinisi | Data biner |
Data biner | Tipe biner | Set dengan jenis media yang cocok | CONVERT_TO_BINARY |
Data biner |
Data biner | Tipe biner | Set dengan jenis media yang cocok | CONVERT_TO_TEXT |
String yang dikodekan Base64 |
Saat mengonversi payload teks menjadi gumpalan biner, API Gateway mengasumsikan bahwa data teks adalah string yang dikodekan base64 dan mengeluarkan data biner sebagai gumpalan yang diterjemahkan base64. Jika konversi gagal, ia mengembalikan 500
respons, yang menunjukkan kesalahan API konfigurasi. Anda tidak menyediakan template pemetaan untuk konversi semacam itu, meskipun Anda harus mengaktifkan perilaku passthrough pada. API
Saat mengonversi payload biner ke string teks, API Gateway selalu menerapkan pengkodean base64 pada data biner. Anda dapat menentukan templat pemetaan untuk muatan semacam itu, tetapi hanya dapat mengakses string yang dikodekan base64 dalam templat pemetaan$input.body
, seperti yang ditunjukkan dalam kutipan contoh templat pemetaan berikut.
{ "data": "$input.body" }
Agar payload biner dilewati tanpa modifikasi, Anda harus mengaktifkan perilaku passthrough pada. API