Tüm Ürünler
Search
Belge Merkezi

API Gateway:Hata kodu tablosundaki hataları giderme

Son Güncelleme:Oct 04, 2026

API unsupport the channel

Nedenler

İstekteki HTTP şeması geçersiz.

Her API belirli bir HTTP şemasını destekler. API sağlayıcıları bir API'nin yalnızca HTTP'ye, yalnızca HTTPS'e veya her ikisine de izin verecek şekilde yapılandırılmasına olanak tanır.

API unsupport the channel: Yalnızca HTTPS'i destekleyen bir API'ye HTTP isteği gönderildi.

API unsupport the channel: Yalnızca HTTP'yi destekleyen bir API'ye HTTPS isteği gönderildi.

Çözümler

API unsupport the channel: API'yi çağırmak için HTTP yerine HTTPS kullanın.

API unsupport the channel: API'yi çağırmak için HTTPS yerine HTTP kullanın.

A403IS

Nedenler

İstemci tarafından sağlanan imza sunucu tarafındaki imza ile eşleşmiyor.

Çözümler

İmzalar eşleşmediğinde API Gateway, X-Ca-Error-Message yanıt üst bilgisinde sunucu tarafındaki StringToSign değerini döndürür.

StringToSign, istek gönderilmeden önce imzanın hesaplanmasında kullanılan dizeyi içerir. Daha fazla bilgi için bkz. API çağırmak için özet kimlik doğrulaması kullanma.

Yerel StringToSign değerinizi yanıtta döndürülen değerle karşılaştırın. Resmi demo kodunu kullandıysanız StringToSign değerini imza hesaplama araç sınıfından alın.

HTTP yanıt üst bilgileri satır sonlarını desteklemez; bu nedenle StringToSign içindeki satır sonları yanıttan kaldırılır. Dizeleri karşılaştırırken bu farkı göz önünde bulundurun.

İstemci ve sunucu taraflarındaki dizeler eşleşiyorsa AppKey ve AppSecret bilgilerinin geçerli olduğunu doğrulayın. Örneğin ekstra boşluk içerip içermediklerini kontrol edin.

Invalid Url

Nedenler

İstekteki HTTP yöntemi, yol veya ortam (X-Ca-Stage) geçersiz.

Örneğin istek test ortamındaki bir API'yi hedefler ancak API bu ortamda yayımlanmamıştır.

Note:

  • İsteğinizde bir ortam belirtmezseniz istek varsayılan olarak üretim (RELEASE) ortamına gönderilir.

  • Bir API tanımını değiştirdiğinizde değişikliklerin etkili olması için API'yi yeniden yayımlamanız gerekir. Bu hata genellikle API yolu değiştirildiğinde ancak API yeniden yayımlanmadığında oluşur.

Çözümler

İsteğinizdeki aşağıdaki üç öğeyi doğrulayın: HTTP yöntemi, yol ve ortam.

  1. API tanımıyla aynı HTTP yöntemini kullanın. Örneğin bir API POST gerektiriyorsa GET isteği göndermeyin.

  2. Doğru istek yolunu kullanın. API'nin sahibiyseniz yapılan tüm değişikliklerden sonra API'yi yeniden yayımlayın.

  3. API'yi çağırmak istediğiniz ortamı belirtin. İsteğinizde X-Ca-Stage üst bilgisini kullanın. Geçerli değerler TEST, PRE ve RELEASE'dir; bu değerler sırasıyla test ortamını, hazırlık ortamını ve üretim ortamını gösterir. Üst bilgiyi belirtmezseniz isteğiniz varsayılan olarak üretim ortamına gönderilir.

Unauthorized

Nedenler

Uygulamanın API'yi çağırma yetkisi yok.

Çözüm

Aşağıdaki çözümleri deneyin:

  1. API'yi siz oluşturduysanız API Gateway konsolunda bir uygulama oluşturun ve bu uygulamaya API'yi çağırma yetkisi verin. Kendi API'nizi test etmek için bile bir uygulama gereklidir.

  2. API'yi satın aldıysanız yetkilendirilmiş API listesini görmek için uygulama ayrıntıları sayfasını kontrol edin. Hedef API listede yoksa yetkilendirme talep edin.

  3. API bir iş ortağına aitse yetkilendirme için iş ortağıyla iletişime geçin. İş ortağının uygulamanızı yetkilendirebilmesi için uygulama kimliğinizi (AppId) sağlayın.

  4. Yetkilendirmeler ortama özeldir. Bir ortamda yetkilendirilen bir uygulama aynı API'yi farklı bir ortamda çağıramaz.

  5. Doğru uygulama ve API kombinasyonunu kullandığınızdan emin olun. Birden fazla uygulamanız veya API'niz olduğunda uyumsuzluklar sık görülür.

I403AA

Nedenler

Çağrı yapan uygulamanın hedef API'yi çağırmak için gereken erişim izinleri yoktur; bu nedenle yetkilendirme denetimi başarısız olur.

API Gateway HTTP durum kodu 403 döndürür. X-Ca-Error-Code yanıt üst bilgisi I403AA ve X-Ca-Error-Message yanıt üst bilgisi Invalid App Authorization no permission değerine sahiptir.

Çözüm

API Gateway konsolunda çağrı yapan uygulamanın hedef API'yi çağırmak için gereken erişim izinlerine sahip olup olmadığını kontrol edin. Yetkilendirme eksikse konsolda çağrı yapan uygulamayı yetkilendirin veya gerekli erişim izinlerini vermek için SetApisAuthorities işlevini çağırın. Ardından isteği yeniden gönderin.