İçeriğe geç
Doğrulandı

Hatalar

Negatif bir kodun ne anlama geldiği ve gerçekte gördüğünüz HTTP durumuna nasıl eşlendiği.

Her yöntem { code, data } ile yanıt verir. code > 0 başarıdır. code < 0 bir hatadır ve data hemen her zaman doğrudan gösterebileceğiniz veya günlüğe yazabileceğiniz, insan tarafından okunabilir bir iletidir.

Gördüğünüz HTTP durumu hikâyenin tamamı değildir

CPI, negatif bir code değerini tek bir kuralla bir HTTP durumuna eşler: -400 ile -499 arasındaki bir kod tam olarak o duruma dönüşür (-404 HTTP 404, -409 HTTP 409, -428 HTTP 428 yanıtı verir). Bunun dışındaki her negatif kod, -1, -500, -762, -999, bu bandın dışındaki herhangi biri, düz bir HTTP 400 yanıtı verir. Asıl ayrıntı her zaman JSON gövdesindedir; bu yüzden yalnızca HTTP durumuna değil, code değerine göre dallanın. -1 ve -999 HTTP katmanında aynı görünür, gövdede ise çok farklıdır.

json
{ "code": -1, "data": "account_not_found" }

Üzerinde dallanmaya değer kodlar

Bu tablonun ötesinde, tek tek mikro hizmetler modüle özgü durumlar için kendi küçük negatif kodlarını kullanır (-90'lar civarında hesap ve faturalama kodları, -762/-764 civarında drive çakışmaları, -450/-460 civarında veritabanı kodları ve daha fazlası). Her zaman açıklayıcı bir data iletisiyle eşleşirler; yalnızca sayıya değil, o iletiye ve çağırdığınız yönteme bakın.

MCP katmanı hataları

Herhangi bir yöntem çalışmadan önce başarısız olan bir istek (kötü veya eksik bir anahtar, bozuk bir MCP iletisi) { code, data } zarfı yerine bir JSON-RPC hatası yanıtı verir:

json
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" }, "id": null }

Bkz. MCP. Bir araç çağrısı gerçekten bir yönteme ulaştığında, sonucu düz bir REST çağrısındaki gibi MCP yanıtının içinde normal { code, data } zarfını taşır.

Sonraki