İçeriğe geç
Doğrulandı

Hata kodları

CPI hata kataloğundaki her negatif kod ve HTTP durumu: ne anlama geldiği ve ne yapılacağı.

Xuda, bir çağrının verebileceği her hatanın tek bir kataloğunu tutar. Bu sayfa, hataların göründüğü yere göre düzenlenmiş o katalogdur. Aynı kodların API'ye özgü anlatımı için Hatalar sayfasına bakın.

HTTP durum hataları

Bunlar, bir sayfaya doğrudan eriştiğinizde de bir cpi çağrısında da aktarım katmanında gördüğünüz durumlardır.

İstemci sözleşmesi kodları

Panonun kendi istemcisi bunları tanır ve genel bir hata iletisi yerine bunlara göre belirli bir arayüz akışı çalıştırır. Faturalama ön ödemeli bakiyeden sonradan ödemeli faturalamaya geçti. Bu yüzden ücretli bir eylemde kalan tek engeller kayıtlı kart eksikliği ve vadesi geçmiş fatura. -92 (negatif bakiye) ve -93 (yükleme gerekli), eskiden bunları fırlatan hesap kapısından kalktı. İstemcide uyumluluk için hâlâ bir -93 işleyicisi var, yalnızca onu tetikleyecek bir şey kalmadı.

Yanıt zarfı

Her yöntem, başarılı da olsa başarısız da olsa, { code, data } yanıtı verir. code >= 1 başarıdır, code < 0 hatadır. Bazı HTTP katmanı hataları, sayısal code yanına bir dize error anahtarı ekler ("rate_limited", "invalid_fields", "appeal_failed"), bazen de bir fields: [] dizisiyle.

CPI, negatif bir code değerini tek bir kuralla HTTP durumuna eşler: -400 ile -499 arasındaki bir kod tam olarak o duruma dönüşür (-400 HTTP 400, -404 HTTP 404, -409 HTTP 409, -428 HTTP 428 verir). Bu aralığın dışındaki diğer her negatif kod (-1, -500, -762, -999) da düz bir HTTP 400 verir. Birkaç ayrı, daha dar uç nokta (genel /cpi/<method> dağıtımı değil, birkaç mağaza ödeme ve herkese açık form rotası) yalnızca -404/-403/-400 değerlerini eşler ve geri kalan her şeyi 422'ye varsayılan yapar. Bu eşleme o rotalara özgüdür ve yukarıdaki genel kuralı tanımlamaz. Dolayısıyla genel dağıtımdan gelen bir -400, 422 değil HTTP 400'dür.

Aynı sayı, özellikle -1 ve -400, farklı anlamlarla yöntemler arasında yeniden kullanılır. Her zaman data iletisini ve çağırdığınız yöntemi okuyun. Aşağıdaki anlamlar yaygın durumdur, garanti değildir.

CPI negatif kodları

Dallanmaya değer kodlar, her cpi/*_module taranarak derlendi.

Bu tablonun ötesinde, tek tek modüller modüle özgü ara durumlar için küçük negatif kodlar kullanır (kabaca -2 ile -25, -44/-45/-46, -64 ile -78, -99/-101/-106). Bunlar neredeyse her zaman açıklayıcı bir data iletisiyle, çoğu kez err.message ile eşleşir. Birine rastladığınızda, yalnızca sayıya güvenmek yerine data dizesini ve kaynak yöntemi okuyun.

Dahili / bildirilmemiş hatalar

Bir avuç hata { code, data } zarfına hiç ulaşmaz: yakalanmamış bir istisna, işlenmemiş bir söz reddi, çıplak bir 401 veya 500 olarak yüzeye çıkan bir throw new Error(...) (örneğin 'app is off', 'Account suspended', 'Account terminated') ya da bir ileti aracısı hatası. Bunlar sabit bir kodla değil, biçimlerine veya kaynaklarına göre tespit edilir ve körü körüne yeniden denemek yerine her zaman yükseltilmeye değer.