Διαχείριση ορίων ρυθμού και σφαλμάτων διακομιστή

Διαχειριστείτε απόκριση 429

Ένα αίτημα που περιορίζεται λόγω ορίου ρυθμού επιστρέφει 429 Too Many Requests, με το detail.status να έχει τιμή rate_limit_exceeded. Διαβάστε τις κεφαλίδες απόκρισης πριν δοκιμάσετε ξανά:

• Το Retry-After δίνει τον ελάχιστο χρόνο αναμονής σε δευτερόλεπτα για ένα αίτημα που απορρίφθηκε.
• Το X-RateLimit-Limit αναφέρει το όριο του κάδου.
• Το X-RateLimit-Remaining αναφέρει πόσα αιτήματα απομένουν.
• Το X-RateLimit-Reset αναφέρει πότε μηδενίζεται ξανά ο κάδος.

Περιμένετε όσο ορίζει το Retry-After και έπειτα δοκιμάστε ξανά με εκθετική οπισθοχώρηση και τυχαία διακύμανση. Μειώστε τα παράλληλα αιτήματα και τοποθετήστε την εργασία σε ουρά αντί να στείλετε απότομα πολλά αιτήματα μόλις μηδενιστεί το χρονικό παράθυρο.

Διαχειριστείτε σφάλματα διακομιστή

Σε απόκριση 500, το δημόσιο σώμα περιέχει γενικό σφάλμα και request_id· δεν επιστρέφονται εσωτερικές λεπτομέρειες εξαίρεσης. Μια απόκριση 503 μπορεί να σημαίνει ότι μια απαραίτητη υπηρεσία δεν είναι προσωρινά διαθέσιμη.

Δοκιμάστε ξανά αιτήματα μόνο για ανάγνωση με περιορισμένη οπισθοχώρηση. Πριν δοκιμάσετε ξανά αίτημα δημιουργίας, ενημέρωσης, πληρωμής ή άλλης αλλαγής κατάστασης, εξακριβώστε αν ολοκληρώθηκε η πρώτη προσπάθεια. Ένα χρονικό όριο ή απόκριση 5xx δεν αποδεικνύει ότι απέτυχε μια μεταβολή· η άμεση επανάληψη μπορεί να δημιουργήσει διπλή εργασία.

Διατηρήστε διαγνωστικά στοιχεία

Καταγράψτε τη χρονική σήμανση, τη μέθοδο, τη διαδρομή, την κατάσταση, το σώμα της απόκρισης και το X-Request-Id. Μην καταγράφετε ποτέ την τιμή x-api-key. Σταματήστε τις αυτόματες επαναλήψεις μετά από μικρό, περιορισμένο αριθμό προσπαθειών και εμφανίστε το σφάλμα για έλεγχο.