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.