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.
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 }:
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.