Siirry sisältöön
Tarkistettu

Virheet

Mitä negatiivinen koodi tarkoittaa ja miten se vastaa HTTP-tilaa, jonka oikeasti näet.

Jokainen metodi vastaa { code, data }. code > 0 on onnistuminen. code < 0 on virhe, ja data on lähes aina ihmisen luettava viesti, jonka voit näyttää tai kirjata sellaisenaan.

Näkemäsi HTTP-tila ei kerro kaikkea

CPI vie negatiivisen code-arvon HTTP-tilaksi yhdellä säännöllä: koodi väliltä -400...-499 muuttuu täsmälleen kyseiseksi tilaksi (-404 vastaa HTTP 404, -409 vastaa HTTP 409, -428 vastaa HTTP 428). Jokainen muu negatiivinen koodi, -1, -500, -762, -999, mikä tahansa tämän alueen ulkopuolella, vastaa tavallista HTTP 400:aa. Todellinen tieto on aina JSON-rungossa, joten haaroita code:n, älä koskaan pelkän HTTP-tilan mukaan. -1 ja -999 näyttävät HTTP-tasolla samalta mutta rungossa hyvin erilaisilta.

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

Koodit, joiden mukaan kannattaa haaroittaa

Tämän taulukon lisäksi yksittäiset mikropalvelut käyttävät omia pieniä negatiivisia koodejaan moduulikohtaisiin tiloihin (tili- ja laskutuskoodit -90-alueella, driven konfliktit -762/-764:n tienoilla, tietokantakoodit -450/-460:n tienoilla ja muita). Niihin liittyy aina kuvaava data-viesti: lue se ja kutsumasi metodi, älä pelkkää numeroa.

MCP-kerroksen virheet

Pyyntö, joka epäonnistuu ennen kuin yhtään metodia ajetaan, eli virheellinen tai puuttuva avain tai virheellinen MCP-viesti, vastaa JSON-RPC-virheellä { code, data }-rakenteen sijaan:

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

Katso MCP. Kun työkalukutsu todella tavoittaa metodin, sen tulos sisältää tavallisen { code, data }-rakenteen MCP-vastauksen sisällä, samoin kuin tavallisessa REST-kutsussa.

Seuraavaksi