Limity żądań Facebook Graph API: błędy 4, 17, 32, 613 i 80001
Graph API Facebooka pozwala tokenowi Strony lub tokenowi użytkownika systemowego wykonać 4,800 wywołań Pages API na każdego zaangażowanego użytkownika w ciągu kroczących 24 godzin. Po przekroczeniu limitu API zwraca: 4, „Osiągnięto limit żądań aplikacji”; 17, „Osiągnięto limit żądań użytkownika”; 32, „Osiągnięto limit żądań Strony”; 613, „Wywołania tego API przekroczyły limit”; albo 80001, „Na to konto Strony wykonano zbyt wiele wywołań”. Przestań wywoływać, a potem wznawiaj stopniowo.
easyCoexistence wywołuje każdą podłączoną Stronę jej własnym tokenem i odbiera jej aktywność w feedzie, wzmianki oraz wiadomości przez webhooki Meta, przekazując je, jeśli chcesz, do Twojego endpointu, więc nic nie musi odpytywać Strony.
Kod, gdy aplikacja, której token jest użyty w żądaniu, osiągnęła swój limit.
Kod, gdy użytkownik, którego token jest użyty w żądaniu, osiągnął swój limit.
Kod, gdy użytkownik lub aplikacja, której token jest użyty w żądaniu do Pages API, osiągnęli swój limit.
Kod niestandardowego limitu; z podkodem 1996 Meta zauważyła niespójne zachowanie w liczbie żądań aplikacji.
Kod limitu Business Use Case dla wywołań Strony wykonywanych tokenem Strony lub tokenem użytkownika systemowego.
Liczba wywołań Pages API dozwolona w ciągu kroczących 24 godzin tokenem Strony lub użytkownika systemowego.
Co oznacza każdy kod limitu?
Każdy kod wskazuje osiągnięty limit, a token w żądaniu decyduje, który z nich obowiązuje. Przewodnik Meta o limitach opisuje, co oznacza każdy kod, a jego dokumentacja błędów podaje towarzyszący komunikat. Poniżej zestawiamy je obok siebie, z komunikatem w brzmieniu Meta:
| Meta's message | What reached its limit | |
|---|---|---|
| 4 | Application request limit reached | The app whose token made the request |
| 17 | User request limit reached | The user whose token made the request |
| 32 | (#32) Page request limit reached | The user or app token used in a Pages API request |
| 613 | (#613) Calls to this api have exceeded the rate limit. | A custom limit set by the API being called |
| 80001 | (#80001) There have been too many calls to this Page account. Wait a bit and try again. | Calls made on that Page with a Page or system user token |
Który limit dotyczy Strony?
Zależy to od tokenu. Meta podaje, że limity Strony mogą korzystać z logiki Platform lub Business Use Case, w zależności od typu użytego tokenu. Wywołania Pages API wykonane tokenem Strony lub użytkownika systemowego podlegają limitowi Business Use Case dla Stron, a wywołania tokenem użytkownika lub aplikacji podlegają limitom Platform użytkownika lub aplikacji. Gdy oba mogą dotyczyć żądania, Meta stosuje limit Business Use Case.
Jak duże są limity?
Meta publikuje wzory, a nie stałe liczby, więc każdy przydział rośnie wraz z użyciem:
- Aplikacje: 200 wywołań na godzinę na każdego dziennie aktywnego użytkownika, liczonych łącznie dla wszystkich wywołań aplikacji, a nie osobno dla każdego użytkownika.
- Strony, tokenem Strony lub użytkownika systemowego: 4,800 wywołań w kroczących 24 godzinach na każdego użytkownika, który w ciągu 24 godzin zaangażował się w Stronę.
- Messenger Send API: 300 wywołań na sekundę na Stronę dla tekstu, linków, reakcji i naklejek oraz 10 dla dźwięku lub wideo.
- Wywołania Messengera mają też własny typ Business Use Case, zgłaszany jako błąd 80006.
Jak zauważyć zbliżający się limit?
Odczytuj nagłówki wykorzystania. Endpointy, do których aplikacja wysyła wystarczająco dużo żądań, zawierają nagłówek X-App-Usage, którego call_count, total_cputime i total_time to procenty limitów Platform aplikacji. Odpowiedzi ograniczone według logiki Business Use Case zawierają zamiast tego X-Business-Use-Case-Usage, z tymi samymi procentami dla każdego obiektu biznesowego, typem limitu, na przykład pages, oraz estimated_time_to_regain_access.
X-App-Usage: {"call_count": 28, "total_time": 25, "total_cputime": 25}
X-Business-Use-Case-Usage: {
"{business-object-id}": [
{
"type": "pages",
"call_count": 100,
"total_cputime": 34,
"total_time": 41,
"estimated_time_to_regain_access": 12
}
]
}Jak długo czekać?
Do momentu, aż wykorzystanie spadnie, co pokazują nagłówki. Przy limicie Business Use Case, takim jak 80001, estimated_time_to_regain_access podaje liczbę minut do chwili, gdy wywołania przestaną być ograniczane. Przy limitach Platform call_count aplikacji obejmuje kroczącą godzinę, więc maleje, gdy starsze wywołania wypadają z okna. Wskazówki Meta są takie same dla obu: przestań wykonywać wywołania po osiągnięciu limitu, bo dalsze wywołania zwiększają licznik wywołań i czas, po którym znów zadziałają.
Jak utrzymać się poniżej limitów?
Wykonuj mniej, lżejszych wywołań i rozkładaj je w czasie. Najlepsze praktyki Meta zalecają równomierne rozkładanie zapytań, aby unikać skoków ruchu, używanie filtrów ograniczających rozmiar odpowiedzi i unikanie wywołań żądających nakładających się danych, a gdy użytkownicy są ograniczani, upewnienie się, że przyczyną nie jest aplikacja. Webhooki też pomagają: Meta dostarcza aktywność w feedzie Strony i wiadomości na bieżąco, więc aplikacja nie musi zużywać wywołań, by ich szukać.
Typowe błędy
- Ponawianie od razu. Meta ostrzega, że dalsze wywołania zwiększają licznik wywołań i czas, po którym wywołania znów zadziałają.
- Traktowanie każdego kodu tak samo. 4 to limit aplikacji, 17 użytkownika, a 80001 Strony, więc zwolnienie niewłaściwego wywołującego nic nie zmienia.
- Odczyt X-App-Usage dla wywołań tokenem Strony. Liczą się one do limitu Business Use Case i są raportowane w X-Business-Use-Case-Usage.
- Częste odpytywanie cichej Strony. Jej przydział rośnie wraz z użytkownikami, którzy się z nią zaangażowali, więc Strona z małym zaangażowaniem ma mniej wywołań do wykorzystania.
Gdy Meta ogranicza wywołanie, narzędzie zwraca kod i komunikat Meta do Claude, ChatGPT lub Twojego kodu, dzięki czemu Twoja AI może poczekać przed kolejną próbą, a post, który Meta ogranicza, ponawiany jest samodzielnie po 5 minutach, 30 minutach i 2 godzinach. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Co oznacza „Osiągnięto limit żądań aplikacji”?
To błąd 4: aplikacja, której token wykonał wywołanie, osiągnęła swój limit. Przestań wywoływać, a potem wznawiaj stopniowo, w miarę spadania jej wykorzystania.
Jaka jest różnica między błędem 32 a błędem 80001?
Token. Błąd 32 to limit Platform dla tokenu użytkownika lub aplikacji wywołującej Pages API; 80001 to limit na Stronę dla wywołań tokenem Strony lub użytkownika systemowego.
Jak długo trwa limit Facebooka?
Meta nie ustala stałego czasu. Dla 80001 nagłówek X-Business-Use-Case-Usage podaje liczbę minut do chwili, gdy wywołania przestaną być ograniczane; wykorzystanie aplikacji mierzone jest w kroczącej godzinie.
Co oznacza błąd 613?
Niestandardowy limit ustawiony przez wywoływane API. Z podkodem 1996 Meta zauważyła niespójne zachowanie w liczbie żądań aplikacji, na przykład po niedawnej zmianie liczby wysyłanych żądań.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w