Διαβάστε ολόκληρη την απάντηση
Για ανεπιτυχή κατάσταση, διατηρήστε τον κωδικό HTTP, τις κεφαλίδες, το σώμα σφάλματος και το αναγνωριστικό αιτήματος αφού αφαιρέσετε τα μυστικά. Αυτά διακρίνουν ένα μη έγκυρο αίτημα από απόρριψη πρόσβασης ή προσωρινό πρόβλημα.
Μην εκθέτετε μια ανεπεξέργαστη απάντηση υπηρεσίας ως μοναδικό μήνυμα προς τον χρήστη: εξηγήστε την ενέργεια, διατηρώντας παράλληλα τις διαγνωστικές λεπτομέρειες για τον χειριστή.
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'Ταξινομήστε την αποτυχία
- Το 4xx συνήθως απαιτεί διόρθωση κλειδιού, δεδομένων εισόδου ή πρόσβασης.
- Το 429 απαιτεί σεβασμό του παραθύρου ορίου και αποφυγή επιθετικών επαναλήψεων.
- Οι αποτυχίες 5xx και δικτύου απαιτούν οριοθετημένες επαναλήψεις με εκθετική καθυστέρηση και τυχαιότητα.
Επαναλάβετε με ασφάλεια
Επαναλάβετε μόνο παροδικές αποτυχίες και μόνο αν η λειτουργία είναι ιδιοδύναμη στο προϊόν σας. Για δημιουργία, κρατήστε ένα αναγνωριστικό αιτήματος πελάτη ώστε να αποτρέψετε διπλή χρέωση ή διπλό τεχνούργημα.
Στη ροή, διακρίνετε ένα σφάλμα πριν από το πρώτο τμήμα από μια διακοπή μετά από μερική έξοδο: η δεύτερη δεν μπορεί να αντικατασταθεί σιωπηρά με νέα απάντηση.