קנה מטבע מבוזר
שלם עם
שווקים
NFT
New
הורדות
English
USD
מרכז תמיכה
שאלות נפוצות
API
כללי מסחר API

שאלות ותשובות בנוגע ל-API ‏(FAQ)

Binance
2021-05-07 08:51

תיעוד API דוגמאות לא רשמיות ל-API 

מהן ההגבלות?

סקירה
ישנם שלושה סוגים שונים של הגבלות, וכולם כפופים לשינויים בכל עת:
  1. הגבלות קשיחות
  2. הגבלות ML (למידה חישובית)
  3. הגבלות WAF (חומת אש של יישום Web)
הגבלות קשיחות:
  • שווה ערך ל-1,200 בקשות בדקה (יש לזכור שנתון זה אינו שווה ערך בהכרח ל-1,200 בקשות)
  • 50 הוראות ב-10 שניות
  • 160,000 הוראות ב-24 שעות
ההגבלות הקשיחות שלנו מפורטות בנקודת הקצה [/api/v3/exchangeInfo] .
הגבלות למידה חישובית:
אופן המסחר נבחן מול זה של המשתמש הממוצע, ואם מזוהה סטייה חריגה מדי תיחסם לפרק זמן מוגדר הנע בין 5 דקות ל-3 ימים.
בהנחה שיש לך ציון שימוש לרעה במסחר.הציון שלך יגדל אם: 
  • תבצע פעולות "one-up" או "front-run" חוזרות על הצעה/דרישת מחיר הטובה ביותר בספר ההוראות.
  • תיצור הוראת ספאם ותבטל אותה מהר מדי מבלי לבצע מסחר.
  • "שיעור ההמרה" שלך נמוך."שיעור המרה מוגדר כמספר פעולות המסחר חלקי המספר הכולל של יצירת הוראות וביטולן בפרק זמן של 24 שעות (מספר פעולות מסחר / (הוראות + ביטולים)).
  • ה"שקלול" שלך נמוך."שקלול" מוגדר ככמות סך המסחר הכוללת שלך חלקי סך יצירות ההוראות והביטולים בפרק זמן של 24 שעות (סה"כ כמות מסחר/ (הוראות + ביטולים)).
  • במהלך יצירה של צמדי מסחר המבוססים על BNB או על נכס ציטוט, ציון השימוש לרעה יגדל.
לא יימסר מידע ספציפי יותר מהאמור לעיל.תוכל לבצע ניסוי וטעייה כדי להגיע לתבנית המסחר האידיאלית שלך, או לדון באופן ההתנהלות האופטימלי עם משתמשי API נוספים.
הגבלות חומת אש של יישום Web:
איננו מספקים פרטים מדוייקים בנוגע לכללי WAF שלנו. עם זאת, אם תקבל שגיאת HTTP 403, פירוש הדבר שהפרת כלל.סביר להניח שהדבר נגרם כתוצאה מבקשות חריגות תוך פרק זמן של 5 דקות.עם זאת, אם אתה שולח בקשה שעלולה להיתפס כזדונית, ייתכן שהדבר יגרום לחסימה לפרק זמן ממושך יותר.

אם אני חורג מההגבלות, האם ההגבלה תהיה על החשבון, על מפתח ה-API או על כתובת ה-IP?

במקרה של הגבלות קשיחות, חריגה מסך הבקשות המשוקלל המותר לדקה (נכון לעתה 1,200) יגרום לחסימת כתובת ה-IP.הגבלת מספר הפקודות (נכון לעתה 50 פעמים לעשר שניות ו-160,000 פעמים ב-24 שעות) תהיה תלויה בחשבון.אם חלה חריגה מהגבלת מספר הפקודות, המשתמשים יוגבלו גם מליצור פקודות חדשות באתר (או ביישומים האחרים שלנו).
במקרה של מגבלות לימוד מכונה (ML), הגבלות יחולו על חשבונות. אם משתמש/ת הוגבל/ה על ידי מערכת ML, ניתן לבדוק את הסיבה לכך ואת משך זמן ההגבלה על ידי השימוש בנקודת הקצה [sapi/v1/account/status/] (מצוין בתיעודה-API שלנו).
הגבלות חומת האש של יישום ה-Web תחולנה רק לפי כתובת IP.לרוב, חסימת WAF תימשך 5 דקות.עם זאת, אם השרת פירש את בקשת המשתמש כזדונית, ייתכן שזמן זה יתארך.

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

לא.עליך לחכות עד לביטול החסימה.

קיבלתי שגיאת HTTP 403 במהלך השימוש ב-API.מדוע?

הפרת את כללי WAF (חומת האש של יישום ה-Web), וסביר להניח שהסיבה לכך היא הפרה של הגבלת דירוג או שליחה של בקשה זדונית (כמתואר בסעיף ההגבלות של מסמך זה).לרוב, החסימות הללו נמשכות 5 דקות.

מדוע חיבורי ה-WebSocket שלי מושמטים/מנותקים?

חיבורי WebSocket פעילים יקבלו ping מדי 3 דקות.אם לא תגיב עם pong בתבנית המתאימה, החיבור שלך ינותק.
במקרה של זרמי נתוני משתמש, אם לא התקבל keep-alive לפחות פעם אחת בכל 60 דקות, תוקף מפתח ההאזנה יפוג. דבר זה מפורט גםבתיעוד ה-API שלנו.

אני משתמש ב-wrapper/שירות חיצוני, והוא אינו עובד.האם תוכלו לעזור?

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

התחלתי לקבל שגיאות, למרות שלא עשיתי כל שינוי.מה קרה?

לצערנו, לא נוכל להציע תמיכה בבעיות שקשורות בהטמעה שתבצע.אם אתה משתמש בכלי או ב-wrapper של ספק חיצוני, אנא צור קשר עם התמיכה או עם צוות הפיתוח שלו לקבלת סיוע.

אני זקוק לגישה אל המפתח הסודי שלי, אבל מוצג "***".כיצד אוכל לברר מהו? 

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

האם אוכל להגדיל את ההגבלות המוטלות עליו או לקבל רוחב פס/שטף ייעודי?

נכון לעתה איננו מציעים זאת.אך תוכל לפעול בכפוף להגבלות שקבענו. 

מפתח ה-API שלי נעלם.הצילו!

ישנם רק שני הסברים אפשריים לכך שמפתח API "ייעלם":
  1. אם לא היית פעיל לאחרונה, והשתמשת ב-API לפני ה-7 במרץ 2018, ייתכן שמפתח/ות ה-API שלך נמחק/ו כדי להבטיח את אבטחת חשבונך.
  2. אם זה לא המקרה, ובחרת לנטרל את חשבונך, הדבר יגרום למחיקה של כל מפתחות ה-API הפעילים אם ישנם.
תוכל ליצור מפתח/ות API חדש/ים ללא בעיה.

אני מקבל את ההודעה "Error -1021 (Message: Timestamp for this request is outside of the recvWindow)" (שגיאה - 1021 (הודעה: חותמת הזמן של בקשה זו מחוץ לתחומי recvWindow)". כיצד אוכל לפתור זאת?

לרוב, שגיאה זו חלה רק במקרים בהם אין סנכרון בין שעון השרת לבין שעון המערכת שלך.ייתכן שיהיה עליך לסנכרן את שעון המערכת שלך.עם זאת, תהליך זה ישתנה כתלות במערכת ההפעלה.
במערכת ההפעלה Windows, תוכל להשתמש בכלי כגון "Atomic Clock" על פי שיקול דעתך.משתמשי Linux ו-Max יוכלו לנסות ולהסתנכרן באמצעות "ntpdate" משורת הפקודה.
אם לא הצלחת לפתור את הבעיה, ייתכן שהיא קשורה בזמן האחזור (בעיית רשת), וייתכן שיהיה עליך לכוון את recvWindow.

האם אוכל לבקש פונקציונליות API חדשה?

אם לא מצאת את הפונקציונליות הדרושה לך בתיעוד שלנו, ניתן להניח שאיננו מציעים אותה.אם תרצה לשלוח לנו הצעה לתכונה מסויימת, תוכל לפתוח קריאת תמיכה ולתאר את ההצעה שלך, כדי שנעיין בה.

אני סבור שיש בעיה ב-API.כיצד עלי לדווח על כך?

אם לדעתך ישנה בעיה במערכת ולא בהטמעה שלך, אנא ספק הוכחות שיתמכו בטענה זו על ידי יצירת קרש עמנו בערוץ ה-צ'אט ה-API שלנו ב-Telegram , ואנו נחקור זאת. לתשומת לבך, איננו מקבלים הודעות לא ברורות כתלונה לגיטימית. בנוסף, זו אינה קבוצה לתמיכה רשמית בתכנות; זו קבוצה קהילתית עבור משתמשי ה-API של Binance.
מאמרים קשורים
כיצד יוצרים API