415 Jenis Media Tidak Didukung - Encoding Tidak Didukung

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Gejala

Aplikasi klien mendapatkan kode status HTTP 415 Unsupported Media Type dengan kode error protocol.http.UnsupportedEncoding sebagai respons terhadap panggilan API.

Pesan error

Aplikasi klien mendapatkan kode respons berikut:

HTTP/1.1 415 Unsupported Media Type

Selain itu, Anda mungkin melihat pesan error yang mirip dengan yang ditampilkan di bawah ini:

{
   "fault":{
      "faultstring":"Unsupported Encoding \"UTF-8\"",
      "detail":{
         "errorcode":"protocol.http.UnsupportedEncoding"
      }
   }
}

Kemungkinan penyebab

Error ini terjadi jika nilai header Content-Encoding yang ditentukan dalam permintaan HTTP yang dikirim oleh klien ke Apigee atau respons HTTP yang dikirim oleh server backend ke Apigee tidak berisi encoding yang didukung oleh Apigee, sesuai spesifikasi RFC 7231, bagian 6.5.13: 415 Supported Media Type.

Kemungkinan penyebab error ini adalah sebagai berikut:

Penyebab	Deskripsi	Petunjuk pemecahan masalah yang berlaku untuk
Encoding tidak didukung yang digunakan dalam permintaan	Header permintaan Content-Encoding berisi encoding yang tidak didukung oleh Apigee Edge.	Pengguna Edge Publik dan Private Cloud
Encoding tidak didukung yang digunakan sebagai respons	Header respons server backend Content-Encoding berisi encoding yang tidak didukung oleh Apigee Edge.	Pengguna Edge Publik dan Private Cloud

Langkah-langkah diagnosis umum

Untuk mendiagnosis error, Anda dapat menggunakan salah satu metode berikut:

Penyebab: Encoding tidak didukung dalam permintaan

Diagnosis

1. Tentukan Kode Kesalahan dan Sumber Kesalahan untuk error yang diamati menggunakan API Monitoring atau log akses NGINX seperti yang dijelaskan dalam Langkah-langkah diagnosis umum.
2. Jika Fault Code adalah protocol.http.UnsupportedEncoding dan Fault Source memiliki nilai apigee atau MP, ini menunjukkan bahwa permintaan yang dikirim oleh aplikasi klien berisi encoding yang tidak didukung di header permintaan Content-Encoding.
3. Anda dapat menentukan nilai encoding yang tidak didukung yang diteruskan sebagai bagian dari permintaan HTTP menggunakan salah satu metode berikut:

   Pesan error

   Menggunakan pesan error:

   1. Jika Anda memiliki akses ke pesan error lengkap yang diterima dari Apigee Edge, lihat faultstring. faultstring berisi nilai endcoding yang tidak didukung.

      Contoh Pesan Error:

      "faultstring":"Unsupported Encoding \"UTF-8\""
      

   2. Dalam pesan error di atas, perhatikan bahwa nilai encoding yang tidak didukung adalah “UTF-8” seperti yang terlihat dalam faultstring.

      Karena “UTF-8” bukan encoding yang didukung di Apigee Edge, permintaan ini gagal dengan error 415 Unsupported Media Type yang berisi kode error: protocol.http.UnsupportedEncoding.

   Permintaan sebenarnya

   Menggunakan permintaan aktual:

   1. Jika Anda tidak memiliki akses ke permintaan aktual yang dibuat oleh aplikasi klien, buka Resolution.
   2. Jika Anda memiliki akses ke permintaan aktual yang dibuat oleh aplikasi klien, lakukan langkah-langkah berikut:
      1. Tentukan nilai yang diteruskan ke header permintaan Content-Encoding.
      2. Jika nilai yang diteruskan ke header permintaan Content-Encoding bukan salah satu dari nilai yang tercantum di Encoding yang didukung, berarti itulah penyebab error ini.

         Contoh permintaan:

         curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: UTF-8" -X POST -d @request_payload.gz
         

         Contoh permintaan di atas mengirimkan nilai "UTF-8" ke header Content- Encoding, yang bukan merupakan Encoding yang Didukung di Apigee Edge. Oleh karena itu, permintaan ini gagal dengan error 415 Unsupported Media Type dengan kode error: protocol.http.UnsupportedEncoding.

Resolusi

1. Lihat daftar encoding yang didukung oleh Apigee di Encoding yang didukung.
2. Pastikan aplikasi klien selalu mengirim hal berikut:
   • Hanya encoding yang didukung sebagai nilai ke header Content-Encoding dalam permintaan
   • Payload permintaan dalam format yang didukung ke Apigee Edge dan cocok dengan format yang ditentukan dalam header Content-Encoding

3. Pada contoh di atas, payload permintaan memiliki ekstensi gz yang menunjukkan bahwa konten harus berupa gzip. Anda dapat memperbaiki masalah ini dengan mengirimkan header permintaan sebagai Content-Encoding: gzip dan payload permintaan dalam format gzip:

   curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.gz
   

Penyebab: Encoding tidak didukung sebagai respons

Diagnosis

1. Tentukan Kode Kesalahan dan Sumber Kesalahan untuk error yang diamati menggunakan Pemantauan API, Alat Pelacakan, atau log akses NGINX seperti yang dijelaskan dalam Langkah-langkah diagnosis umum.
2. Jika Fault Source memiliki nilai target, ini menunjukkan bahwa respons yang dikirim oleh server backend berisi encoding yang tidak didukung di header Content-Encoding.
3. Anda dapat menentukan nilai encoding yang tidak didukung yang diteruskan sebagai bagian dari respons HTTP dari server backend menggunakan salah satu metode berikut:

   Pesan error

   Menggunakan pesan error:

   1. Jika Anda memiliki akses ke pesan error lengkap yang diterima dari Apigee Edge, lihat faultstring. faultstring berisi nilai encoding yang tidak didukung.

      Contoh pesan error:

      "faultstring":"Unsupported Encoding \"UTF-8\""
      

   2. Dalam pesan error di atas, perhatikan bahwa nilai encoding yang tidak didukung adalah “UTF-8” seperti yang terlihat dalam faultstring.

      Karena “UTF-8” bukan encoding yang didukung di Apigee Edge, permintaan ini gagal dengan error 415 Unsupported Media Type yang berisi kode error: protocol.http.UnsupportedEncoding.

   Alat pelacak

   Menggunakan Trace:

   1. Jika Anda tidak memiliki rekaman aktivitas untuk permintaan yang gagal, buka Resolution.
   2. Jika telah merekam rekaman aktivitas kegagalan, Anda dapat menentukan encoding yang tidak didukung yang diteruskan oleh server backend sebagai bagian dari header respons Content-Encoding seperti yang dijelaskan di Alat pelacakan.

Resolusi

1. Lihat daftar encoding yang didukung oleh Apigee di Encoding yang didukung
2. Pastikan server backend selalu mengirim hal berikut:
   • Hanya encoding yang didukung sebagai nilai ke header Content-Encoding dalam permintaan
   • Payload respons dalam format yang didukung ke Apigee Edge dan cocok dengan format yang ditentukan dalam header Content-Encoding

Encoding yang didukung

Tabel berikut mencantumkan format encoding yang didukung oleh Apigee Edge:

Header	Encoding	Deskripsi
Content-Encoding	gzip	Format gzip Unix
	deflate	Format ini menggunakan struktur zlib dengan algoritme kompresi deflate.

Spesifikasi

Apigee merespons dengan respons error 415 Unsupported Media Type sesuai spesifikasi RFC berikut:

Spesifikasi
RFC 7231, bagian 6.5.13: 415 Jenis Media yang Tidak Didukung

Poin-poin penting yang perlu diperhatikan

Perhatikan hal berikut:

• Jika error 415 ditampilkan oleh Apigee karena encoding yang tidak didukung diteruskan di header Content-Encoding sebagai bagian dari permintaan API, maka:
  • Anda tidak akan dapat merekam aktivitas untuk permintaan tersebut.

  • Anda tidak akan dapat mengubah format atau isi respons error yang dikirim oleh Apigee Edge menggunakan kebijakan seperti RaiseFault, ProvideMessage.

  Hal ini dikarenakan error ini terjadi pada fase awal dalam Pemroses Pesan sebelum kebijakan apa pun dapat dijalankan.

• Jika error 415 ditampilkan oleh Apigee karena encoding yang tidak didukung diteruskan di header respons dari server backend Anda, error tersebut harus diperbaiki di server backend untuk menghindari error ini. Silakan bekerja sama dengan tim backend Anda untuk memperbaiki masalah ini.

Jika Anda masih memerlukan bantuan dari Dukungan Apigee Edge, buka Harus mengumpulkan informasi diagnostik.

Harus mengumpulkan informasi diagnostik

Jika Anda masih memerlukan bantuan dari Dukungan Apigee, kumpulkan informasi diagnostik berikut, lalu hubungi Dukungan Apigee Edge:

Jika Anda adalah pengguna Cloud Publik, berikan informasi berikut:

• Nama organisasi
• Nama lingkungan
• Nama Proxy API
• Selesaikan perintah curl yang digunakan untuk mereproduksi error 415
• File rekaman aktivitas untuk permintaan API

Jika Anda adalah pengguna Private Cloud, berikan informasi berikut:

• Pesan error lengkap yang diamati untuk permintaan yang gagal
• Nama lingkungan
• Paket Proxy API
• File rekaman aktivitas untuk permintaan API

• Log akses NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Tempat: ORG, ENV, dan PORT# diganti dengan nilai sebenarnya.

• Log sistem Pemroses Pesan /opt/apigee/var/log/edge-message- processor/logs/system.log