Όρια ποσοστών

Για να διασφαλίσει υψηλή απόδοση και αξιοπιστία για όλους τους χρήστες, το SMSBAT εφαρμόζει περιορισμό ρυθμού σε αιτήματα API. Τα όρια χρέωσης καθορίζουν τον μέγιστο αριθμό κλήσεων API που μπορείτε να πραγματοποιήσετε εντός ενός δεδομένου χρονικού πλαισίου.

Προεπιλεγμένα όρια

Εκτός εάν ορίζεται διαφορετικά στη σύμβασή σας, τα προεπιλεγμένα όρια ποσοστού εφαρμόζονται σε όλα τα τελικά σημεία API (SMSBAT API, Cascade API και ChatHub API).

Κατηγορία API	Προεπιλεγμένο όριο	Όριο ριπής
Τελικά σημεία ανταλλαγής μηνυμάτων (`/bat/messagelist`)	100 αιτήματα / δευτερόλεπτο	150 αιτήματα / δευτερόλεπτο
Τελικά σημεία δεδομένων (Κατάσταση, Υπόλοιπο, Πληροφορίες)	50 αιτήματα / δευτερόλεπτο	75 αιτήματα / δευτερόλεπτο

[!ΣΗΜΕΙΩΣΗ] Για τα εξερχόμενα μηνύματα (π.χ. "POST /bat/messagelist"), ένα αίτημα HTTP μπορεί να περιέχει έως και 5.000 μηνύματα στον πίνακα "μηνυμάτων". Το όριο χρέωσης ισχύει για τον αριθμό αιτημάτων HTTP και όχι για τον αριθμό των μηνυμάτων που αποστέλλονται.

Όρια ποσοστού χειρισμού

Εάν υπερβείτε το επιτρεπόμενο όριο χρέωσης, το API θα απαντήσει με έναν κωδικό κατάστασης HTTP «429 πάρα πολλά αιτήματα».

Παράδειγμα απόκρισης

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

Βέλτιστες πρακτικές

Για να αποφύγετε τον περιορισμό του ποσοστού, λάβετε υπόψη τις ακόλουθες βέλτιστες πρακτικές:

Μαζέψτε τα μηνύματά σας: Αντί να στέλνετε 1.000 ξεχωριστά αιτήματα HTTP για 1.000 μηνύματα SMS, στείλτε ένα αίτημα που περιέχει μια σειρά από 1.000 αντικείμενα.
Εφαρμογή εκθετικής επιστροφής: Εάν λάβετε έναν κωδικό κατάστασης 429, περιμένετε για ένα μικρό χρονικό διάστημα (π.χ. 1 δευτερόλεπτο) και δοκιμάστε ξανά. Εάν αποτύχει ξανά, διπλασιάστε το χρόνο αναμονής (2 δευτ., 4 δευτ., 8 δευτ., κ.λπ.).
Ρυθμίστε τα αιτήματά σας: Εάν εκτελείτε ένα αυτοματοποιημένο σενάριο που ενεργοποιεί χιλιάδες κλήσεις API, εισάγετε μια μικρή καθυστέρηση (π.χ. sleep(10) χιλιοστά του δευτερολέπτου) μεταξύ των αιτημάτων.

Αίτημα για αύξηση ορίου

Εάν η περίπτωση χρήσης σας απαιτεί μεγαλύτερη απόδοση από τα προεπιλεγμένα όρια, μπορείτε να ζητήσετε αύξηση.

Επικοινωνήστε με τον αποκλειστικό διαχειριστή του λογαριασμού σας ή στείλτε email στο [email protected].
Καταχωρίστε το αναγνωριστικό του λογαριασμού σας και την αναμενόμενη απόδοση (π.χ. 500 αιτήματα ανά δευτερόλεπτο).
Περιγράψτε εν συντομία την περίπτωση χρήσης σας.

Η τεχνική ομάδα μας θα εξετάσει το αίτημά σας και θα προσαρμόσει ανάλογα τα όριά σας.