ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
Meta Tech Provider

Σφάλμα WhatsApp 4: η εφαρμογή έφτασε το όριο κλήσεων API

Ο κωδικός σφάλματος 4 σημαίνει ότι η εφαρμογή έφτασε το όριο κλήσεων API. Η περιγραφή της Meta είναι «The app has reached its API call rate limit.» Μετράει τις κλήσεις της εφαρμογής μέσα σε μια κυλιόμενη ώρα και όχι τα μηνύματα που στέλνει ένας αριθμός. Ελέγξτε τη χρήση στο App Dashboard, περιμένετε και μειώστε τη συχνότητα με την οποία η εφαρμογή καλεί το API.

4

Ο κωδικός της Meta για το «The app has reached its API call rate limit.»

200 x users

Οι κλήσεις που επιτρέπεται να κάνει μια εφαρμογή σε μία ώρα, σύμφωνα με τα Graph API Platform Rate Limits.

API Too Many Calls

Το όνομα που δίνει ο οδηγός χειρισμού σφαλμάτων του Graph API στον κωδικό 4.

Τι σημαίνει ο κωδικός σφάλματος 4 του WhatsApp;

Σημαίνει ότι η εφαρμογή σας έχει κάνει υπερβολικά πολλές κλήσεις API στο τρέχον παράθυρο και οι επόμενες απορρίπτονται μέχρι να μειωθεί το πλήθος.

Η Meta κατατάσσει τον κωδικό 4 στα σφάλματα περιορισμού (throttling) με το κείμενο λεπτομερειών «The app has reached its API call rate limit.» Ο οδηγός χειρισμού σφαλμάτων του Graph API τον ονομάζει API Too Many Calls και τον περιγράφει ως προσωρινό πρόβλημα περιορισμού.

Υπάρχουν δύο άλλοι κωδικοί περιορισμού που μπερδεύονται εύκολα μαζί του. Ο 80007 αφορά τον λογαριασμό WhatsApp Business που έφτασε το όριό του. Ο 130429 αφορά τη ροή μηνυμάτων του Cloud API. Ο κωδικός 4 δεν είναι κανένας από τους δύο: είναι το δικό της όριο κλήσεων της εφαρμογής.

Πώς υπολογίζεται το όριο κλήσεων της εφαρμογής;

Για αιτήματα που γίνονται με app access token, ο οδηγός rate limiting του Graph API της Meta δίνει έναν τύπο: οι κλήσεις μέσα σε μία ώρα ισούνται με 200 επί τον αριθμό των χρηστών.

Ο αριθμός των χρηστών βασίζεται στους μοναδικούς ημερήσιους ενεργούς χρήστες της εφαρμογής, ενώ χρησιμοποιούνται εβδομαδιαία και μηνιαία στοιχεία όταν η ημερήσια χρήση πέφτει. Το όριο ισχύει για την εφαρμογή συνολικά και όχι ανά χρήστη, επομένως λίγοι πολύ ενεργοί χρήστες μπορούν να καταναλώσουν το μεγαλύτερο μέρος του.

Ο οδηγός αναφέρει επίσης ότι η χρήση εμφανίζεται στο App Dashboard και, αφού γίνουν αρκετές κλήσεις, στην κεφαλίδα X-App-Usage των αποκρίσεων. Αυτή η κεφαλίδα είναι ο τρόπος να δείτε το όριο να πλησιάζει πριν εμφανιστεί το σφάλμα 4.

Τι πρέπει να κάνετε μετά το σφάλμα 4;

Σταματήστε τις κλήσεις για λίγο και στη συνέχεια καλείτε λιγότερο.

Ο οδηγός rate limiting της Meta είναι σαφής για το πρώτο μέρος: όταν έχει επιτευχθεί το όριο, σταματήστε να κάνετε κλήσεις API, επειδή η συνέχιση αυξάνει το πλήθος των κλήσεων και μεγαλώνει τον χρόνο μέχρι οι κλήσεις να πετυχαίνουν ξανά.

Το δεύτερο μέρος αφορά τον σχεδιασμό. Κατανείμετε τα αιτήματα ομοιόμορφα αντί για κύματα, φιλτράρετε τις αποκρίσεις ώστε μία κλήση να επιστρέφει όσα χρειάζεστε και αποφύγετε κλήσεις που φέρνουν επικαλυπτόμενα δεδομένα. Το συνεχές polling είναι ο συνηθισμένος ένοχος. Μια ενσωμάτωση που ζητά την ίδια κατάσταση λογαριασμού κάθε λίγα δευτερόλεπτα ξοδεύει το όριό της σε απαντήσεις που ήδη έχει.

Συνηθισμένα λάθη

  • Επανάληψη των αιτημάτων σε βρόχο. Κάθε επιπλέον κλήση προστίθεται στο πλήθος και απομακρύνει την ανάκαμψη.
  • Αντιμετώπιση του κωδικού ως ορίου αποστολής. Ο κωδικός 4 μετράει τις κλήσεις της εφαρμογής, ενώ η ροή μηνυμάτων αντιστοιχεί στον 130429.
  • Polling των endpoints κατάστασης σε μικρό διάστημα. Οι επαναλαμβανόμενες αναγνώσεις αμετάβλητων δεδομένων ξοδεύουν το ωριαίο όριο.
Κάντε το με EasyCoexistence

Το EasyCoexistence παρακολουθεί κάθε συνδεδεμένο αριθμό 24/7 από τη δική του πλευρά, οπότε ο έλεγχος της υγείας της σύνδεσης δεν χρειάζεται να υλοποιηθεί ως βρόχος polling εις βάρος του ορίου κλήσεων της εφαρμογής σας.

Συχνές ερωτήσεις

Είναι το σφάλμα 4 ίδιο με το σφάλμα 130429;

Όχι. Ο 130429 αφορά τη ροή μηνυμάτων ενός αριθμού. Το σφάλμα 4 αφορά το πλήθος των κλήσεων API που έχει κάνει η εφαρμογή σας.

Πόσο διαρκεί το σφάλμα 4;

Μέχρι το πλήθος κλήσεων στο κυλιόμενο παράθυρο μίας ώρας να πέσει κάτω από το όριο. Αν καλείτε στο μεταξύ, η διάρκεια παρατείνεται.

Πού μπορώ να δω πόσο κοντά είναι η εφαρμογή μου στο όριο;

Στην ενότητα Application Rate Limit του App Dashboard και στην κεφαλίδα X-App-Usage που επιστρέφεται στις αποκρίσεις.

Είναι το σφάλμα 4 ίδιο με το σφάλμα 80007;

Όχι. Η Meta χρησιμοποιεί τον 80007 όταν ο λογαριασμός WhatsApp Business φτάνει το όριό του, ενώ το σφάλμα 4 μετράει τις δικές της κλήσεις της εφαρμογής.

Συνεχίστε την ανάγνωση

Έτοιμοι να ξεκινήσετε;

Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.

Ξεκινήστε δωρεάν δοκιμή

Επαληθεύτηκε στις

Σφάλμα WhatsApp 4: όριο κλήσεων API