Τεκμηρίωση API丨Βιβλιοθήκες ανοιχτού κώδικα και παραδείγματα API
Ποια είναι τα όρια;
Επισκόπηση
Υπάρχουν τρεις διαφορετικοί τύποι ορίων και όλοι που υπόκεινται σε αλλαγές ανά πάσα στιγμή:
- Ανώτατα όρια
- Όρια ML (Μηχανική μάθηση)
- Όρια WAF (Τείχος προστασίας εφαρμογών ιστού).
Ανώτατα όρια
- Συντελεστής 6.000 αιτημάτων ανά λεπτό (λάβετε υπόψη ότι αυτό δεν είναι απαραίτητα το ίδιο με 6.000 αιτήματα)
- 50 εντολές ανά 10 δευτερόλεπτα
- 160.000 εντολές ανά 24 ώρες
Τα ανώτατα όριά μας είναι καταχωρημένα στο τελικό σημείο [/api/v3/exchangeInfo].
Όρια μηχανικής μάθησης
Η συμπεριφορά συναλλαγών αξιολογείται βάσει του μέσου χρήστη. Εάν αποκλίνετε πολύ, θα αποκλειστείτε για ένα καθορισμένο χρονικό διάστημα που κυμαίνεται από 5 λεπτά έως 3 ημέρες.
Ας υποθέσουμε ότι έχετε βαθμολογία κατάχρησης συναλλαγών. Η βαθμολογία σας θα αυξηθεί εάν:
- Αν επανειλημμένα ξεπερνάτε την ή προπορεύεστε στην καλύτερη προσφορά/Ζήτηση στο βιβλίο εντολών.
- Δημιουργείτε και ακυρώνετε εντολές πολύ γρήγορα, χωρίς να εκτελείτε συναλλαγές.
- Το "ποσοστό μετατροπής" σας είναι χαμηλό. Το "ποσοστό μετατροπής" ορίζεται ως ο αριθμός των συναλλαγών σας διαιρούμενος με τις συνολικές εντολές που δημιουργήθηκαν και ακυρώθηκαν σε ένα διάστημα 24 ωρών (Αριθμός συναλλαγών / (Εντολές + Ακυρώσεις)).
- Η "στάθμισή" σας είναι χαμηλή. Ως "στάθμιση" ορίζεται η συνολική ποσότητα συναλλαγών σας δια τις συνολικές εντολές που δημιουργήθηκαν και ακυρώθηκαν σε ένα διάστημα 24 ωρών (Συνολική ποσότητα συναλλαγών / (Εντολές + Ακυρώσεις)).
- Κατά τη συναλλαγή ζευγών που έχουν το BNB ως βάση ή στοιχείο ενεργητικού προσφοράς, η βαθμολογία κατάχρησης θα αυξηθεί.
Δεν θα δοθούν πιο συγκεκριμένες πληροφορίες από τις παραπάνω. Ακολουθήστε την τεχνική δοκιμών και σφαλμάτων για να πετύχετε το ιδανικό μοτίβο συναλλαγών ή συζητήστε τη βέλτιστη συμπεριφορά με άλλους χρήστες API.
Όρια WAF (Τείχος προστασίας εφαρμογών ιστού)
Παρόλο που δεν παρέχουμε ακριβείς λεπτομέρειες για τους κανόνες WAF μας, εάν λάβετε ένα σφάλμα HTTP 403, έχετε παραβιάσει κάποιον κανόνα. Πιθανότατα, θα είναι αποτέλεσμα υπερβολικών αιτημάτων σε διάρκεια 5 λεπτών. Ωστόσο, εάν στέλνετε ένα αίτημα που θα μπορούσε να θεωρηθεί ως κακόβουλο, αυτό θα μπορούσε να οδηγήσει σε περιορισμό μεγαλύτερης διάρκειας.
Εάν υπερβώ τα όρια, θα περιοριστεί ο λογαριασμός, το κλειδί API ή η διεύθυνση IP μου;
Όσον αφορά τα ανώτατα όρια, η υπέρβαση του ορίου συνολικού όγκου αιτημάτων ανά λεπτό (επί του παρόντος 6.000) θα οδηγήσει σε περιορισμό IP. Τα όρια εντολών (προς το παρόν είναι 50 φορές/10 δευτερόλεπτα και 160.000 φορές/24 ώρες) θα εξαρτώνται από τον λογαριασμό. Εάν έχει ξεπεραστεί το όριο εντολών, θα περιοριστεί η δυνατότητά σας να δημιουργείτε νέες εντολές στον ιστότοπο (ή σε άλλες εφαρμογές μας).
Όσον αφορά τα όρια Μηχανικής μάθησης, θα ισχύουν περιορισμοί στους λογαριασμούς. Εάν έχετε περιοριστεί από το σύστημα ML, μπορείτε να ελέγξετε την αιτία και τη διάρκεια χρησιμοποιώντας το τελικό σημείο [/sapi/v1/account/status] (συμπεριλαμβάνεται στην τεκμηρίωση API μας).
Οι περιορισμοί του τείχους προστασίας εφαρμογών ιστού θα εφαρμόζονται μόνο κατά διεύθυνση IP. Συνήθως, η απαγόρευση WAF διαρκεί 5 λεπτά. Ωστόσο, εάν ο διακομιστής έχει ερμηνεύσει το αίτημα ενός χρήστη ως κακόβουλο, μπορεί να παραταθεί.
Είχα περιοριστεί λόγω υπέρβασης των ορίων, αλλά επιδιόρθωσα τον κώδικά μου. Θα αρθεί ο περιορισμός μου νωρίτερα;
Όχι. Πρέπει να περιμένετε μέχρι να λήξει ο περιορισμός.
Γιατί έλαβα ένα σφάλμα HTTP 403, όταν χρησιμοποιούσα το API;
Παραβιάσατε τους κανόνες WAF (Τείχος προστασίας εφαρμογών ιστού), πιθανότατα παραβιάζοντας ένα όριο ποσοστού ή στέλνοντας ένα κακόβουλο αίτημα (όπως περιγράφεται στην ενότητα ορίων αυτού του εγγράφου). Συνήθως, τέτοιου είδους απαγορεύσεις διαρκούν 5 λεπτά.
Γιατί απορρίπτονται/αποσυνδέονται οι συνδέσεις μου στο WebSocket;
Κάθε 3 λεπτά, οι ενεργές συνδέσεις στο WebSocket θα λαμβάνουν ένα πρωτόκολλο ping. Εάν δεν απαντήσετε με ένα σωστά δημιουργημένο πρωτόκολλο ping, η σύνδεσή σας θα τερματιστεί.
Για ροές δεδομένων χρήστη, εάν δεν λαμβάνεται ειδοποίηση ενεργής σύνδεσης τουλάχιστον μία φορά κάθε 60 λεπτά, το κλειδί ακρόασης θα λήξει. Αυτό αναλύεται, επίσης, στην τεκμηρίωση API μας.
Χρησιμοποιώ υπηρεσία/πρόγραμμα τρίτου μέρους και δεν λειτουργεί. Μπορείτε να βοηθήσετε;
Δυστυχώς, δεν υποστηρίζουμε υπηρεσίες ή εργαλεία τρίτων. Επικοινωνήστε με την υπηρεσία ή/και τους προγραμματιστές για περαιτέρω βοήθεια.
Επιπλέον, αποτελεί κίνδυνο για την ασφάλεια να εισαγάγετε τα Κλειδιά Binance API ή/και τα Μυστικά κλειδιά σε οποιαδήποτε πλατφόρμα τρίτου μέρους. Χρησιμοποιήστε αυτές τις υπηρεσίες κατά τη διακριτική σας ευχέρεια.
Λάβετε υπόψη ότι αποφεύγουμε να παρέχουμε γενική βοήθεια προγραμματισμού.
Παρόλο που δεν έχω κάνει αλλαγές, λαμβάνω ξαφνικά σφάλματα. Τι συνέβη;
Δυστυχώς, δεν μπορούμε να παρέχουμε υποστήριξη σε ζητήματα που αφορούν την προσωπική σας εφαρμογή. Εάν χρησιμοποιείτε πρόγραμμα/εργαλείο τρίτου, επικοινωνήστε με την ομάδα υποστήριξης/ανάπτυξης για βοήθεια.
Χρειάζομαι πρόσβαση στο μυστικό κλειδί μου αλλά εμφανίζεται ως "***". Πώς μπορώ να το ανακτήσω;
Για λόγους ασφαλείας, βάσει σχεδιασμού, τα Μυστικά κλειδιά είναι ορατά μόνο τη στιγμή που δημιουργείται το Κλειδί API. Οποιαδήποτε στιγμή μετά από αυτό, θα είναι κρυμμένα. Εάν τα έχετε χάσει ή δεν τα σημειώσατε, θα χρειαστεί να δημιουργήσετε ένα νέο Κλειδί API και να το χρησιμοποιήσετε με ένα νέο Μυστικό κλειδί.
Μπορώ να αυξήσω τα όριά μου ή την αποκλειστική ροή/το αποκλειστικό εύρος ζώνης μου;
Δυστυχώς, αυτή η δυνατότητα δεν προσφέρεται επί του παρόντος. Θα πρέπει να μπορείτε να εργαστείτε με τους περιορισμούς που παρέχονται.
Το Κλειδί API μου εξαφανίστηκε.
Υπάρχουν μόνο δύο πιθανές εξηγήσεις για την "εξαφάνιση" ενός Κλειδιού API:
- Εάν δεν ήσασταν ενεργοί πρόσφατα και χρησιμοποιούσατε το API πριν από τις 7 Μαρτίου 2018, είναι πιθανό να διαγράφτηκαν τα Κλειδιά API σας για να διασφαλιστεί η ασφάλεια του λογαριασμού σας.
- Εάν έχετε απενεργοποιήσει τον λογαριασμό σας, αυτό θα είχε ως αποτέλεσμα τη διαγραφή όλων των ενεργών Κλειδιών API.
Λογικά θα μπορέσετε να δημιουργήσετε ένα νέο Κλειδί API χωρίς προβλήματα.
Λαμβάνω σφάλμα "Error -1021 (Message: Timestamp for this request is outside of the recvWindow)" [Σφάλμα -1021 (Μήνυμα: Η χρονοσήμανση για αυτό το αίτημα είναι εκτός του recvWindow)]. Πώς μπορώ να το επιλύσω;
Συνήθως, αυτό το σφάλμα παρουσιάζεται μόνο εάν δεν συγχρονίζεται η ώρα του διακομιστή και η ώρα του συστήματός σας. Ίσως χρειαστεί να συγχρονίσετε το ρολόι του συστήματός σας. Ωστόσο, αυτή η διαδικασία διαφέρει ανάλογα με το λειτουργικό σύστημα.
Για τα Windows, κατά τη διακριτική σας ευχέρεια, μπορείτε να χρησιμοποιήσετε ένα εργαλείο όπως το "Atomic Clock". Οι χρήστες Linux και Mac μπορούν να προσπαθήσουν τον συγχρονισμό με το "ntpdate" μέσω της γραμμής εντολών.
Εάν το πρόβλημα παραμένει, μπορεί να σχετίζεται με τον χρόνο αδράνειας (πρόβλημα δικτύου). Προσπαθήστε να προσαρμόσετε το recvWindow σας.
Μπορώ να ζητήσω νέες λειτουργίες API;
Εάν δεν βλέπετε τη λειτουργία που ζητάτε στην τεκμηρίωσή μας, θα πρέπει να υποθέσετε ότι δεν την παρέχουμε. Εάν θέλετε να προτείνετε μια λειτουργία, μπορείτε να ανοίξετε ένα δελτίο υποστήριξης και θα το ελέγξουμε.
Πιστεύω ότι υπάρχει πρόβλημα με το API. Πώς μπορώ να κάνω αναφορά;
Εάν πιστεύετε ότι υπάρχει πρόβλημα με το σύστημα και όχι με τη δική σας υλοποίηση, στείλτε τα αποδεικτικά στοιχεία για να υποστηρίξετε τον ισχυρισμό σας, επικοινωνώντας μαζί μας στο φόρουμ προγραμματιστών και θα το διερευνήσουμε. Λάβετε υπόψη ότι δεν δεχόμαστε ασαφή μηνύματα ως έγκυρες καταγγελίες.
Τελευταία ενημέρωση: 24 Οκτωβρίου 2023