Κωδικοί σφαλμάτων
Κάθε αρνητικός κωδικός και κατάσταση HTTP του καταλόγου σφαλμάτων του CPI, τι σημαίνει και τι να κάνετε.
Το Xuda διατηρεί έναν κατάλογο με κάθε σφάλμα που μπορεί να επιστρέψει μια κλήση. Αυτή η σελίδα είναι ο κατάλογος αυτός, οργανωμένος ανάλογα με το πού εμφανίζεται το σφάλμα. Δείτε τα Σφάλματα για την πλαισίωση των ίδιων κωδικών ειδικά για το API.
Σφάλματα κατάστασης HTTP
Αυτές είναι οι καταστάσεις που βλέπετε στο επίπεδο μεταφοράς, είτε ανοίγετε μια σελίδα απευθείας είτε κάνετε μια κλήση cpi.
Κωδικοί σύμβασης client
Ο ίδιος ο client του πίνακα ελέγχου αναγνωρίζει αυτούς τους κωδικούς και ξεκινά με βάση αυτούς μια συγκεκριμένη ροή UI αντί για ένα γενικό μήνυμα σφάλματος. Η χρέωση πέρασε από προπληρωμένο υπόλοιπο σε μεταπληρωμένη τιμολόγηση, οπότε οι μόνες πύλες που απομένουν σε μια επί πληρωμή ενέργεια είναι η απουσία κάρτας και ένα ληξιπρόθεσμο τιμολόγιο. Τα -92 (αρνητικό υπόλοιπο) και -93 (απαιτείται αναπλήρωση) έχουν φύγει από την πύλη λογαριασμού που τα πετούσε παλαιότερα: ένας χειριστής -93 υπάρχει ακόμη στον client για συμβατότητα, απλώς δεν έχει πια τίποτα που να τον ενεργοποιεί.
Το περιτύλιγμα απάντησης
Κάθε μέθοδος, με επιτυχία ή αποτυχία, απαντά { code, data }. Το code >= 1 είναι επιτυχία: το code < 0 είναι σφάλμα. Ορισμένα σφάλματα του επιπέδου HTTP προσθέτουν ένα κλειδί error τύπου string δίπλα στον αριθμητικό code ("rate_limited", "invalid_fields", "appeal_failed"), μερικές φορές με έναν πίνακα fields: [].
Το CPI αντιστοιχίζει έναν αρνητικό code σε κατάσταση HTTP με έναν κανόνα: ένας κωδικός από -400 έως -499 γίνεται ακριβώς αυτή η κατάσταση (το -400 απαντά HTTP 400, το -404 απαντά HTTP 404, το -409 απαντά HTTP 409, το -428 απαντά HTTP 428). Κάθε άλλος αρνητικός κωδικός, -1, -500, -762, -999, οτιδήποτε εκτός αυτής της ζώνης, απαντά επίσης με απλό HTTP 400. Μερικά ξεχωριστά, στενότερα τελικά σημεία (κάποιες διαδρομές ολοκλήρωσης αγοράς καταστήματος και δημόσιων φορμών, όχι η γενική αποστολή /cpi/<method>) αντιστοιχίζουν μόνο τα -404/-403/-400 και ορίζουν ως προεπιλογή το 422 για όλα τα υπόλοιπα: αυτή η αντιστοίχιση ισχύει τοπικά σε εκείνες τις διαδρομές και δεν περιγράφει τον γενικό κανόνα παραπάνω, άρα ένα -400 από τη γενική αποστολή είναι HTTP 400, όχι 422.
Ο ίδιος αριθμός επαναχρησιμοποιείται σε διαφορετικές μεθόδους με διαφορετικό νόημα, ειδικά το -1 και το -400. Διαβάζετε πάντα το μήνυμα data και τη μέθοδο που καλέσατε: οι σημασίες παρακάτω είναι η συνηθισμένη περίπτωση, όχι εγγύηση.
Αρνητικοί κωδικοί CPI
Οι κωδικοί στους οποίους αξίζει να διακλαδίζεστε, συγκεντρωμένοι από σάρωση κάθε cpi/*_module.
Πέρα από αυτόν τον πίνακα, μεμονωμένα modules χρησιμοποιούν μικρούς αρνητικούς κωδικούς (περίπου -2 έως -25, -44/-45/-46, -64 έως -78, -99/-101/-106) για ενδιάμεσες καταστάσεις ειδικές για το module. Σχεδόν πάντα συνοδεύονται από ένα περιγραφικό μήνυμα data, συχνά το err.message. Όταν συναντήσετε έναν, διαβάστε το string data και τη μέθοδο προέλευσης αντί να βασίζεστε μόνο στον αριθμό.
Εσωτερικά / μη δηλωμένα σφάλματα
Μερικές αποτυχίες δεν φτάνουν ποτέ στο περιτύλιγμα { code, data }: μια μη πιασμένη εξαίρεση, μια μη χειρισμένη απόρριψη promise, ένα throw new Error(...) που εμφανίζεται ως γυμνό 401 ή 500 (για παράδειγμα 'app is off', 'Account suspended', 'Account terminated'), ή μια αποτυχία του message broker. Εντοπίζονται από τη μορφή ή την πηγή και όχι από σταθερό κωδικό, και αξίζει πάντα να τις κλιμακώνετε αντί να δοκιμάζετε τυφλά ξανά.