Sari la conținut
Verificat

Erori

Ce înseamnă un cod negativ și cum se potrivește cu statusul HTTP pe care îl vezi de fapt.

Fiecare metodă răspunde { code, data }. code > 0 înseamnă succes. code < 0 este o eroare, iar data este aproape întotdeauna un mesaj lizibil pe care îl poți afișa sau înregistra direct.

Statusul HTTP pe care îl vezi nu spune totul

CPI mapează un code negativ la un status HTTP cu o singură regulă: un cod de la -400 la -499 devine exact acel status (-404 răspunde cu HTTP 404, -409 cu HTTP 409, -428 cu HTTP 428). Orice alt cod negativ, -1, -500, -762, -999, orice în afara acelui interval, răspunde cu un simplu HTTP 400. Detaliul real se află mereu în corpul JSON, așa că ramifică logica după code, niciodată doar după statusul HTTP. Un -1 și un -999 arată identic la nivelul HTTP și foarte diferit în corp.

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

Coduri pe care merită să ramifici logica

Dincolo de acest tabel, microserviciile individuale folosesc propriile coduri negative mici pentru stări specifice modulului (coduri de cont și facturare în jur de -90, conflicte Drive în jur de -762/-764, coduri de bază de date în jur de -450/-460 și altele). Sunt mereu însoțite de un mesaj descriptiv în data; citește acel mesaj și metoda pe care ai apelat-o, nu doar numărul.

Erori la nivelul MCP

O cerere care eșuează înainte să ruleze vreo metodă, o cheie greșită sau lipsă, un mesaj MCP malformat, primește ca răspuns o eroare JSON-RPC în locul plicului { code, data }:

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

Vezi MCP. Odată ce un apel de instrument ajunge cu adevărat la o metodă, rezultatul lui poartă plicul obișnuit { code, data } în interiorul răspunsului MCP, ca la un apel REST simplu.

Mai departe