全部产品
Search
文档中心

API Gateway:Memecahkan masalah kesalahan dalam tabel kode kesalahan

更新时间:Jul 02, 2025

API tidak mendukung saluran

Penyebab

Skema HTTP dalam permintaan tidak valid.

API yang berbeda mendukung skema HTTP yang berbeda. Penyedia API dapat mengonfigurasi skema HTTP yang didukung. Sebagai contoh, mereka dapat mengizinkan hanya permintaan HTTP, hanya HTTPS, atau keduanya.

API tidak mendukung saluran: Kesalahan ini dilaporkan ketika permintaan HTTP digunakan untuk memanggil API yang hanya mendukung HTTPS.

API tidak mendukung saluran: Kesalahan ini dilaporkan ketika permintaan HTTPS digunakan untuk memanggil API yang hanya mendukung HTTP.

Solusi

API tidak mendukung saluran: Gunakan permintaan HTTPS, bukan HTTP, untuk memanggil API.

API tidak mendukung saluran: Gunakan permintaan HTTP, bukan HTTPS, untuk memanggil API.

A403IS

Penyebab

Tanda tangan yang diberikan oleh klien tidak sesuai dengan tanda tangan di sisi server.

Solusi

Jika tanda tangan tidak cocok, API Gateway mengembalikan parameter StringToSign yang digunakan untuk perhitungan tanda tangan di sisi server dalam header respons X-Ca-Error-Message.

Parameter StringToSign mencakup string yang digunakan untuk menghitung tanda tangan sebelum permintaan dikirim. Untuk informasi lebih lanjut, lihat Gunakan Otentikasi Digest untuk Memanggil API.

Anda dapat memperoleh StringToSign lokal dan membandingkannya dengan StringToSign yang dikembalikan dalam respons untuk menemukan perbedaan dan penyesuaian. Jika Anda menggunakan demo resmi untuk melakukan panggilan, Anda dapat memperoleh StringToSign yang digunakan untuk perhitungan tanda tangan melalui alat kelas perhitungan tanda tangan.

Karena jeda baris tidak diizinkan dalam header respons HTTP, jeda baris dalam parameter StringToSign dihapus dalam respons. Lihat dokumentasi dan bandingkan string dengan benar.

Jika string sisi klien dan sisi server konsisten, periksa apakah AppKey dan AppSecret yang digunakan valid. Sebagai contoh, pastikan AppKey dan AppSecret tidak mengandung spasi tambahan.

Url Tidak Valid

Penyebab

Metode HTTP, path, atau lingkungan (X-Ca-Stage) yang ditentukan dalam permintaan tidak valid.

Sebagai contoh, permintaan dibuat untuk memanggil API dalam lingkungan pengujian, tetapi API belum diterbitkan dalam lingkungan tersebut.

Notes:

  • Jika Anda tidak menentukan lingkungan dalam permintaan, permintaan akan dikirim ke lingkungan produksi (RELEASE) secara default.

  • Jika Anda memodifikasi definisi API, API harus diterbitkan ulang agar modifikasi berlaku. Dalam banyak kasus, kesalahan ini terjadi karena API tidak diterbitkan ulang setelah jalurnya dimodifikasi, tetapi jalur baru ditentukan dalam permintaan.

Solusi

Periksa permintaan atau API Anda berdasarkan tiga faktor: metode HTTP, path, dan lingkungan.

  1. Tentukan metode HTTP yang sama dalam permintaan seperti pada definisi API. Sebagai contoh, jika API perlu dipanggil menggunakan metode POST, jangan gunakan GET dalam permintaan.

  2. Tentukan path dalam permintaan berdasarkan path aktual yang digunakan. Jika Anda memodifikasi API, pastikan untuk menerbitkannya ulang setelah modifikasi.

  3. Tentukan lingkungan tempat Anda ingin memanggil API. Gunakan header X-Ca-Stage dalam permintaan. Nilai yang valid adalah TEST, PRE, dan RELEASE, yang masing-masing menunjukkan lingkungan pengujian, lingkungan staging, dan lingkungan produksi. Jika Anda tidak menentukan header, permintaan akan dikirim ke lingkungan produksi secara default.

Tidak Diotorisasi

Penyebab

Aplikasi tidak memiliki izin untuk memanggil API.

Solusi

Coba solusi berikut:

  1. Jika Anda membuat API, buat aplikasi dan otorisasi aplikasi untuk memanggil API di konsol API Gateway. Aplikasi diperlukan untuk memanggil API, bahkan jika Anda hanya memanggilnya untuk pengujian.

  2. Jika Anda membeli API, Anda dapat melihat API yang dapat Anda panggil menggunakan aplikasi tertentu di halaman detail aplikasi. Jika API yang ingin Anda panggil tidak ditampilkan, Anda harus mendapatkan otorisasi untuk aplikasi tersebut.

  3. Jika Anda memanggil API milik mitra Anda, hubungi mitra tersebut untuk otorisasi. Dalam hal ini, Anda harus memberikan ID aplikasi Anda (AppId) kepada mitra untuk mengotorisasi aplikasi tersebut.

  4. Otorisasi bergantung pada lingkungan. Aplikasi yang telah diotorisasi tidak dapat digunakan untuk memanggil API yang sama dalam lingkungan yang berbeda.

  5. Periksa apakah Anda menggunakan aplikasi yang benar dan memanggil API yang benar. Pemanggil sering kali menggunakan aplikasi yang salah atau memanggil API yang salah ketika ada banyak aplikasi atau API.