לדלג לתוכן

מגבלות תעריף

כדי להבטיח ביצועים ואמינות גבוהים עבור כל המשתמשים, SMSBAT מחיל הגבלת קצב לבקשות API. מגבלות תעריף מציינות את המספר המרבי של קריאות API שאתה יכול לבצע במסגרת זמן נתונה.

מגבלות ברירת מחדל

אלא אם צוין אחרת בחוזה שלך, מגבלות התעריף המוגדרות כברירת מחדל חלות על כל נקודות הקצה של ה-API (SMBAT API, Cascade API ו-ChatHub API).

קטגוריית API מגבלת ברירת מחדל מגבלת פרץ
נקודות קצה להודעות (/bat/messagelist) 100 בקשות לשנייה 150 בקשות לשנייה
נקודות קצה לנתונים (סטטוס, יתרה, מידע) 50 בקשות לשנייה 75 בקשות/שנייה

[!הערה] עבור הודעות יוצאות (למשל, POST /bat/messagelist), בקשת HTTP אחת יכולה להכיל עד 5,000 הודעות במערך הודעות. מגבלת התעריף חלה על מספר בקשות HTTP, לא על מספר ההודעות שנשלחו.

מגבלות קצב טיפול

אם תחרוג ממגבלת הקצב המותרת, ה-API יגיב עם קוד סטטוס HTTP 429 Too Many Requests.

דוגמה לתגובה

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

שיטות עבודה מומלצות

כדי להימנע מהגבלת תעריפים, שקול את השיטות המומלצות הבאות:

  1. אצווה את ההודעות שלך: במקום לשלוח 1,000 בקשות HTTP נפרדות עבור 1,000 הודעות SMS, שלח בקשה בודדת המכילה מערך של 1,000 אובייקטים.
  2. הטמיע גיבוי אקספוננציאלי: אם אתה מקבל קוד סטטוס '429', המתן תקופה קצרה (למשל, שנייה אחת), ונסה שוב. אם הוא נכשל שוב, הכפיל את זמן ההמתנה (2 שניות, 4 שניות, 8 שניות וכו').
  3. קצב הבקשות שלך: אם אתה מפעיל סקריפט אוטומטי שמפעיל אלפי קריאות API, הכנס השהייה קטנה (לדוגמה, sleep(10) אלפיות השנייה) בין בקשות.

בקשת הגדלת הגבלה

אם מקרה השימוש שלך דורש תפוקה גבוהה יותר ממגבלות ברירת המחדל, תוכל לבקש הגדלה.

  1. צור קשר עם מנהל החשבון הייעודי שלך או דוא"ל [email protected].
  2. ספק את מזהה החשבון שלך ואת התפוקה הצפויה (למשל, 500 בקשות בשנייה).
  3. תאר בקצרה את מקרה השימוש שלך.

הצוות הטכני שלנו יבדוק את בקשתך ויתאים את המגבלות שלך בהתאם.