Σφάλματα
Τι σημαίνει ένας αρνητικός κωδικός, και πώς αντιστοιχίζεται στο status HTTP που βλέπετε πραγματικά.
Κάθε μέθοδος απαντά { code, data }. Το code > 0 είναι επιτυχία. Το code < 0 είναι σφάλμα, και το data είναι
σχεδόν πάντα ένα μήνυμα αναγνώσιμο από άνθρωπο που μπορείτε να εμφανίσετε ή να καταγράψετε απευθείας.
Το status HTTP που βλέπετε δεν είναι όλη η ιστορία
Το CPI αντιστοιχίζει έναν αρνητικό code σε status HTTP με έναν κανόνα: ένας κωδικός από -400 έως -499 γίνεται
ακριβώς εκείνο το status (το -404 απαντά με HTTP 404, το -409 με HTTP 409, το -428 με HTTP 428).
Κάθε άλλος αρνητικός κωδικός, -1, -500, -762, -999, οτιδήποτε εκτός αυτής της ζώνης, απαντά με
απλό HTTP 400. Η πραγματική λεπτομέρεια βρίσκεται πάντα στο σώμα JSON, οπότε διακλαδώστε με βάση το code, ποτέ μόνο με βάση
το status HTTP. Ένα -1 και ένα -999 μοιάζουν ίδια στο επίπεδο HTTP και πολύ διαφορετικά στο
σώμα.
Κωδικοί που αξίζει να διακλαδώσετε
Πέρα από αυτόν τον πίνακα, μεμονωμένα microservices χρησιμοποιούν δικούς τους μικρούς αρνητικούς κωδικούς για καταστάσεις ειδικές της ενότητας
(κωδικοί λογαριασμού και χρέωσης στα -90, συγκρούσεις drive γύρω στα -762/-764, κωδικοί βάσης δεδομένων
γύρω στα -450/-460, και άλλα). Συνοδεύονται πάντα από ένα περιγραφικό μήνυμα data,
διαβάστε αυτό το μήνυμα και τη μέθοδο που καλέσατε και όχι μόνο τον αριθμό.
Σφάλματα στο επίπεδο MCP
Ένα αίτημα που αποτυγχάνει πριν εκτελεστεί οποιαδήποτε μέθοδος, ένα κακό ή απόν κλειδί, ένα κακοσχηματισμένο μήνυμα MCP,
απαντά με σφάλμα JSON-RPC αντί για τον φάκελο { code, data }:
Δείτε το MCP. Όταν μια κλήση εργαλείου φτάσει πράγματι σε μια μέθοδο, το αποτέλεσμά της φέρει τον κανονικό
φάκελο { code, data } μέσα στην απάντηση MCP, όπως σε μια απλή κλήση REST.