Όρια Ρυθμού
Το VaultPAM API επιβάλλει όρια ρυθμού ανά πελάτη για την προστασία της σταθερότητας της υπηρεσίας. Όλες οι απαντήσεις API περιλαμβάνουν κεφαλίδες x-ratelimit-* ώστε ο πελάτης σας να μπορεί να παρακολουθήσει την τρέχουσα κατανάλωση και να υποχωρήσει ομαλά πριν φτάσει ένα όριο.
Κεφαλίδες Απάντησης
Κάθε απάντηση API περιλαμβάνει τις ακόλουθες κεφαλίδες:
| Κεφαλίδα | Τύπος | Περιγραφή |
|---|---|---|
x-ratelimit-limit | integer | Μέγιστος αριθμός αιτημάτων που επιτρέπονται στο τρέχον χρονικό διάστημα |
x-ratelimit-remaining | integer | Αιτήματα που απομένουν στο τρέχον χρονικό διάστημα |
x-ratelimit-reset | Unix timestamp (seconds) | Πότε θα επαναφερθεί το τρέχον χρονικό διάστημα |
Σε μια απάντηση 429 Too Many Requests, περιλαμβάνεται μια επιπλέον κεφαλίδα:
| Κεφαλίδα | Τύπος | Περιγραφή |
|---|---|---|
retry-after | integer (seconds) | Ελάχιστος χρόνος αναμονής πριν από επανάληψη |
Όλες οι κεφαλίδες χρησιμοποιούν ονόματα με πεζά γράμματα.
Κατηγορίες Ορίων Ρυθμού
Το API εφαρμόζει διαφορετικά όρια ανάλογα με τον τύπο της λειτουργίας και το πλαίσιο κλήσης. Οι κεφαλίδες x-ratelimit-* σε κάθε απάντηση αντικατοπτρίζουν την κατηγορία ορίου που ισχύει για αυτό το συγκεκριμένο αίτημα.
Τιμές αναφοράς (καθοδήγηση μόνο — θεωρήστε τις κεφαλίδες x-ratelimit-* ως έγκυρες):
| Κατηγορία | Όριο |
|---|---|
| Προσπάθειες σύνδεσης ανά IP | 60 ανά λεπτό |
| Αιτήματα API ανά IP | 300 ανά λεπτό |
| Αιτήματα API ανά έγκυρο χρήστη | 120 ανά λεπτό |
| Ευαίσθητες λειτουργίες ανά χρήστη | 30 ανά λεπτό |
Τα όρια που παρουσιάζονται παραπάνω τεκμηριώνουν τις τρέχουσες προεπιλογές. Χρησιμοποιήστε τις τιμές x-ratelimit-limit και x-ratelimit-remaining σε κάθε απάντηση για να λάβετε αποφάσεις επανάληψης — οι δημοσιευμένοι αριθμοί μπορεί να αλλάξουν χωρίς προειδοποίηση.
Διαχείριση Απαντήσεων 429
Όταν λαμβάνετε απάντηση 429 Too Many Requests:
- Διαβάστε την τιμή της κεφαλίδας
retry-after(δευτερόλεπτα). - Σταματήστε τον βρόχο αιτημάτων για τουλάχιστον αυτή τη διάρκεια.
- Επαναλάβετε το αίτημα.
Παράδειγμα απάντησης:
HTTP/1.1 429 Too Many Requests
x-ratelimit-limit: 120
x-ratelimit-remaining: 0
x-ratelimit-reset: 1747483200
retry-after: 37
Content-Type: application/json
{
"error": "RATE_LIMITED",
"message": "Too many requests. Retry after 37 seconds."
}
Συνιστώμενα Μοτίβα Πελάτη
Ελέγξτε τον υπόλοιπο προϋπολογισμό πριν από λειτουργίες σε μαζική κλίμακα
Διαβάστε το x-ratelimit-remaining μετά από κάθε απάντηση. Εάν πέσει κάτω από ένα όριο (για παράδειγμα, 10), εισάγετε ένα διάλειμμα πριν από το επόμενο αίτημα για να αποφύγετε την ενεργοποίηση ενός 429.
Εκθετική υποχώρηση για παροδικές απαντήσεις 429
Εάν το retry-after δεν υπάρχει ή λάβετε πολλές διαδοχικές απαντήσεις 429, χρησιμοποιήστε εκθετική υποχώρηση με jitter:
wait = min(base * 2^attempt + random_jitter, max_wait)
Καταγράψτε το x-ratelimit-reset για αποσφαλμάτωση
Κατά τη διάγνωση προβλημάτων ορίου ρυθμού, καταγράψτε το Unix timestamp x-ratelimit-reset μαζί με την απάντηση. Μετατρέψτε σε ευανάγνωστη ώρα για να κατανοήσετε πότε αναλύεται το χρονικό διάστημα.
Επόμενα Βήματα
- Ροή Ελέγχου Ταυτότητας — αποκτήστε tokens πριν κάνετε κλήσεις API
- curl Γρήγορη Εκκίνηση — δείτε τις κεφαλίδες ορίου ρυθμού σε δράση