Ugrás a tartalomhoz
Ellenőrizve

Hibák

Mit jelent a negatív kód, és hogyan képeződik le a ténylegesen látott HTTP-állapotra.

Minden metódus { code, data } választ ad. A code > 0 siker. A code < 0 hiba, és a data szinte mindig olyan, ember által olvasható üzenet, amelyet közvetlenül megjeleníthet vagy naplózhat.

A látott HTTP-állapot nem a teljes történet

A CPI egyetlen szabállyal képezi le a negatív code értéket HTTP-állapotra: a -400 és -499 közötti kód pontosan az az állapot lesz (a -404 HTTP 404-et, a -409 HTTP 409-et, a -428 HTTP 428-at ad). Minden más negatív kód, a -1, -500, -762, -999, bármi ezen az egy sávon kívül, sima HTTP 400-at ad. A valódi részlet mindig a JSON-törzsben van, ezért a code alapján ágazzon el, soha ne csak a HTTP-állapot alapján. A -1 és a -999 a HTTP-rétegben azonosnak látszik, a törzsben pedig nagyon különbözőnek.

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

Az elágazásra érdemes kódok

Ezen a táblázaton túl az egyes mikroszolgáltatások saját, kis negatív kódokat használnak a moduljukra jellemző állapotokra (fiók- és számlázási kódok a -90-es tartományban, Drive-ütközések a -762/-764 körül, adatbázis-kódok a -450/-460 körül, és más). Mindig leíró data üzenet társul hozzájuk, a számot önmagában helyett az üzenetet és a hívott metódust olvassa.

MCP-rétegbeli hibák

Az a kérés, amely bármilyen metódus futása előtt meghiúsul, rossz vagy hiányzó kulcs, hibás MCP-üzenet, JSON-RPC hibával válaszol a { code, data } burkoló helyett:

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

Lásd az MCP oldalt. Amint egy eszközhívás ténylegesen eljut egy metódushoz, az eredménye az MCP-válaszon belül a szokásos { code, data } burkolót hordozza, ugyanúgy, mint a sima REST-hívás.

Következő