Fejl
Hvad en negativ code betyder, og hvordan den svarer til den HTTP-status, du faktisk ser.
Hver metode svarer { code, data }. code > 0 er succes. code < 0 er en fejl, og data er næsten altid en
læsbar besked, du kan vise eller logge direkte.
Den HTTP-status, du ser, er ikke hele historien
CPI oversætter en negativ code til en HTTP-status med én regel: en kode fra -400 til -499 bliver
præcis den status (-404 giver HTTP 404, -409 giver HTTP 409, -428 giver HTTP 428). Enhver anden
negativ kode, -1, -500, -762, -999, alt uden for det ene bånd, giver en almindelig HTTP 400. De
egentlige detaljer står altid i JSON-kroppen, så forgren på code, aldrig kun på HTTP-statussen. Et -1 og
et -999 ser ens ud på HTTP-laget og meget forskellige ud i kroppen.
Koder, det er værd at forgrene på
Ud over denne tabel bruger de enkelte mikrotjenester deres egne små negative koder til modulspecifikke
tilstande (konto- og faktureringskoder i -90'erne, Drive-konflikter omkring -762/-764, databasekoder
omkring -450/-460 og flere). De er altid parret med en beskrivende data-besked. Læs den besked og den
metode, du kaldte, i stedet for tallet alene.
Fejl på MCP-laget
En anmodning, der fejler, før nogen metode kører, en forkert eller manglende nøgle, en forkert udformet
MCP-besked, besvares med en JSON-RPC-fejl i stedet for { code, data }-konvolutten:
Se MCP. Når et værktøjskald faktisk når en metode, bærer dets resultat den normale
{ code, data }-konvolut inde i MCP-svaret, ligesom et almindeligt REST-kald.