Σφάλματα

Τα εργαλεία Listano Control MCP μπορούν να επιστρέψουν σφάλματα από πιστοποίηση, άδειες, επικύρωση, ελέγχους ετοιμότητας ή αποτυχίες backend fetch.

Το ασφαλέστερο μοτίβο ανάκαμψης είναι:

1. επιθεώρηση του σφάλματος
2. κλήση whoami εάν οι άδειες είναι ασαφείς
3. κλήση get-offering εάν η τρέχουσα κατάσταση πρόχειρου είναι ασαφής
4. διόρθωση μόνο των συγκεκριμένων μη έγκυρων ή ελλειπόντων δεδομένων
5. κλήση check-offering-publish-readiness ξανά πριν τη δημοσίευση

Σφάλματα αδειών

Ένα σφάλμα άδειας σημαίνει ότι η πιστοποιημένη ενσωμάτωση δεν έχει το απαιτούμενο scope.

Ανάκαμψη:

• καλέστε whoami
• επιβεβαιώστε τα χορηγηθέντα scopes
• ζητήστε να χορηγηθεί το ελλείπον scope

Σφάλματα "δεν βρέθηκε"

Μια προσφορά μπορεί να μην βρεθεί όταν:

• το offeringId είναι λανθασμένο
• η προσφορά ανήκει σε άλλη εταιρεία
• η ενσωμάτωση είναι πιστοποιημένη για διαφορετική εταιρεία

Ανάκαμψη:

• καλέστε list-offerings με τίτλο, SKU ή άλλο γνωστό αναγνωριστικό
• επιβεβαιώστε την επιλεγμένη προσφορά πριν τη μεταβάλετε

Σφάλματα επικύρωσης

Τα σφάλματα επικύρωσης συνήθως σημαίνουν ότι το σχήμα εισόδου ή η τιμή πεδίου δεν είναι έγκυρη.

Συνηθισμένες αιτίες:

Σφάλματα ετοιμότητας δημοσίευσης

Το check-offering-publish-readiness επιστρέφει:

{
  offeringId: string
  publishable: boolean
  errors: unknown[]
}

Όταν το publishable είναι false, μην καλέσετε publish-offering.

Συνηθισμένα προβλήματα ετοιμότητας:

• ελλείπων τίτλος, περιγραφή ή μονάδα μέτρησης κύριας γλώσσας
• ελλείπουσες μεταφράσεις για υποστηριζόμενες μη κύριες γλώσσες
• ελλείπουσες μεταφρασμένες ετικέτες κατηγοριών
• ελλείπουσες μεταφράσεις χαρακτηριστικών
• μη έγκυρος συνδυασμός τιμής/μονάδας χαρακτηριστικού
• ελλείπουσες μεταφρασμένες περιγραφές χαρακτηριστικών ή ετικέτες τιμών

Ανάκαμψη:

1. διορθώστε τα επιστρεφόμενα σφάλματα
2. καλέστε check-offering-publish-readiness ξανά
3. δημοσιεύστε μόνο όταν το publishable είναι true

Σφάλματα κύκλου ζωής πρόχειρου

Εάν το kind ή το language είναι λανθασμένο, μην επιχειρήσετε να το επιδιορθώσετε.

Αυτά τα πεδία είναι αμετάβλητα. Η σωστή ανάκαμψη είναι να απορρίψετε το πρόχειρο με discard-offering-draft και να δημιουργήσετε νέα προσφορά.

Εάν μια προσφορά έχει ήδη δημοσιευμένη τρέχουσα έκδοση, η απόρριψη του πρόχειρου δεν αφαιρεί την ενεργή έκδοση.

Σφάλματα δημοσίευσης

Το publish-offering μπορεί να αποτύχει εάν το πρόχειρο είναι ελλιπές ή μη έγκυρο.

Ανάκαμψη:

• καλέστε check-offering-publish-readiness
• διορθώστε τα επιστρεφόμενα σφάλματα
• επιχειρήστε δημοσίευση μόνο αφού περάσει η ετοιμότητα

Αποτυχίες backend fetch

Ένα εργαλείο μπορεί να επιστρέψει αποτυχία fetch όταν το αίτημα backend αποτυγχάνει πριν επιστραφεί έγκυρη απόκριση.

Ανάκαμψη:

• επαναλάβετε την ίδια λειτουργία μόνο ανάγνωσης εάν είναι σκόπιμο
• αποφύγετε την επανάληψη κλήσεων μεταβολής εκτός αν η τρέχουσα κατάσταση έχει ελεγχθεί με get-offering
• αναφέρετε το μήνυμα σφάλματος εάν η αποτυχία επιμένει