Słownik

Limit API Bluesky przeliczony na posty na godzinę

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •9 min czytania
Limit API Bluesky przeliczony na posty na godzinęLimit API Bluesky przeliczony na posty na godzinę

TL;DR, szybka odpowiedź

9 min czytania

Bluesky mierzy zapisy rekordów w punktach, a nie w żądaniach. Każde konto dostaje 5 000 punktów na godzinę i 35 000 na dobę, przy czym CREATE kosztuje 3 punkty, UPDATE 2, a DELETE 1. To daje 1 666 postów na godzinę, 11 666 na dobę i 486 na godzinę, jeśli chcesz działać przez całą dobę bez przestojów. Osobno obowiązuje 3 000 żądań na pięć minut na adres IP, a próby logowania mają limit znacznie niższy od obu tych wartości.

Czym jest limit API Bluesky?

Każdy limit API Bluesky dotyczący zapisu jest wyrażony w punktach, a nie w żądaniach: PDS Bluesky daje każdemu kontu 5 000 punktów na godzinę i 35 000 punktów na dobę, a CREATE kosztuje 3 punkty, UPDATE 2 punkty i DELETE 1 punkt. Żądania, które przekraczają limit, dostają odpowiedź HTTP 429.

Niemal każde inne API społecznościowe liczy wywołania. Bluesky liczy operacje na rekordach wewnątrz tych wywołań, sumuje je na konto (na DID, a nie na hasło aplikacji czy token) i nakłada budżet punktów na osobny budżet żądań HTTP. Oficjalna strona o limitach mówi o tym wprost: "These limits are on top of any related HTTP API requests."

Koszty w punktach, prosto z dokumentacji:

Typ działaniaWartość
CREATE3 punkty
UPDATE2 punkty
DELETE1 punkt

Dokumentacja przelicza to na rekordy tylko w jednym przypadku, polubień, i na tym poprzestaje. Resztę obliczeń znajdziesz poniżej.

Ile postów na godzinę może opublikować jedno konto na Bluesky?

Jedno konto może utworzyć 1 666 rekordów na godzinę i 11 666 rekordów na dobę, a post na Bluesky to jeden rekord. Wystarczy podzielić budżet przez koszt:

OperacjaPunkty za sztukęNa godzinę (5 000 pkt)Na dobę (35 000 pkt)
CREATE (post, polubienie, repost, obserwacja)31 66611 666
UPDATE (putRecord)22 50017 500
DELETE (cofnięcie polubienia, przestanie obserwować, usunięcie posta)15 00035 000

Wartości dla CREATE są zaokrąglone w dół i co godzinę zostają dwa niewykorzystane punkty, bo 5 000 podzielone przez 3 to 1 666,67, a 35 000 podzielone przez 3 to 11 666,67. Dokumentacja podaje 1 666 i 11 666, co się zgadza.

Grupowanie zapisów nie pomaga w przypadku punktów. Jedno wywołanie com.atproto.repo.applyWrites może zawierać wiele zapisów rekordów, a dokumentacja jasno stwierdza, że limity "sum up all of those individual record writes." Grupowanie pomaga za to przy budżecie żądań, o którym piszemy dalej.

Post, polubienie, repost i obserwacja kosztują tyle samo: 3 punkty. Kolekcje rekordów to app.bsky.feed.post, app.bsky.feed.like, app.bsky.feed.repost i app.bsky.graph.follow, a budżet ich nie rozróżnia, więc bot obserwujący i bot publikujący czerpią z jednej puli.

Dlaczego limit dobowy to tylko siedem godzin limitu godzinowego?

Dobowy pułap 35 000 punktów to dokładnie siedem razy więcej niż godzinowy pułap 5 000, więc siedem godzin pracy na pełnych obrotach wyczerpuje całą dobę. Dokumentacja o tym nie wspomina, a to najbardziej przydatna informacja przed napisaniem narzędzia do planowania.

Gdyby liczył się tylko pułap godzinowy, doba pozwalałaby na 5 000 razy 24, czyli 120 000 punktów. Limit dobowy to 29 procent tej wartości. Pułap godzinowy to dopuszczalny skok, a pułap dobowy to prawdziwy budżet.

Dla wszystkiego, co działa bez przerwy, liczy się tempo, które da się utrzymać:

OknoPunktyOperacje CREATE
Skok, jedna godzina5 0001 666
Stałe tempo, na godzinę przez 24 h1 458486
Stałe tempo, na minutę248

Ostatni wiersz to liczba, pod którą warto projektować. 11 666 operacji CREATE na 1 440 minut daje 8,1 na minutę, czyli jeden zapis co 7,4 sekundy. Proces działający szybciej pożycza z dalszej części doby, a proces pracujący na pułapie godzinowym traci budżet w ósmej godzinie.

Ile naprawdę kosztuje wątek, edycja albo usunięty post?

Wątek kosztuje 3 punkty za każdy zawarty w nim post, bo każdy post w wątku to osobny rekord. Struktura odpowiedzi niczego nie daje za darmo. Oto obliczenia dla schematów zapisu, z których ludzie faktycznie korzystają:

SchematPunktyNa godzinęNa dobę
Jeden post31 66611 666
Wątek z pięciu postów153332 333
Post, potem edycja (createRecord plus putRecord)51 0007 000
Post, potem usunięcie41 2508 750
Polubienie, potem jego cofnięcie41 2508 750

Obrazy i wideo zmieniają liczbę żądań, a nie liczbę punktów. Przesłanie bloba przez com.atproto.repo.uploadBlob nie jest zapisem rekordu, więc kosztuje zero punktów: post z czterema obrazami to pięć żądań HTTP i 3 punkty. Limity rozmiaru blobów i limit 300 grafemów w tekście posta to osobne tematy i żaden z nich nie wpływa na budżet zapisów.

Telefon z komunikatem o błędzie, ilustrujący, co się dzieje, gdy aplikacja trafia na limit.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Który limit zadziała pierwszy: budżet punktów czy budżet żądań?

Przy pojedynczym koncie pierwszy zadziała budżet punktów, a przy grupie kont korzystających z jednego adresu IP budżet żądań. Bluesky stosuje oba jednocześnie: 3 000 żądań na pięć minut mierzone na adres IP dla wszystkich endpointów oraz budżet punktów mierzony na konto.

Przelicz limit żądań na te same jednostki. 3 000 na pięć minut to 600 na minutę i 36 000 na godzinę. Jedno konto zapisujące na pełnych obrotach wykonuje 1 666 operacji CREATE na godzinę, czyli jedną dwudziestą limitu IP, więc pojedynczy bot nigdy go nie zobaczy.

Teraz umieść kilka kont za jednym adresem IP. Przy równomiernym rozłożeniu jedno konto na pułapie godzinowym wykonuje 1 666 podzielone przez 12, czyli 138,8 żądań zapisu na pięciominutowe okno. Podziel 3 000 przez 138,8, a otrzymasz 21,6. Dwadzieścia jeden kont mieści się pod pułapem IP z wynikiem 2 915 żądań, a dwudzieste drugie przekracza go, osiągając 3 054. Ten punkt przecięcia nie jest nigdzie opublikowany i to przez niego automatyzacja wielu kont z jednego serwera zachowuje się inaczej niż ten sam kod na jednym koncie. Dokumentacja nie wyjaśnia, jak oba budżety współdziałają, gdy się zderzą, podaje tylko, że oba istnieją.

Osoba wpisuje dane w formularzu logowania na laptopie, co nawiązuje do sekcji o limitach logowania.

Jakie są limity logowania i dlaczego dają się we znaki przed limitami zapisu?

com.atproto.server.createSession ma limit 30 na 5 minut i 300 na dobę na konto, czyli jest 39 razy surowszy niż budżet zapisów, do którego daje dostęp. Automatyzacja, która loguje się od nowa przed każdym postem, ma realny pułap 300 postów na dobę, a nie 11 666, bo 11 666 podzielone przez 300 to 38,9.

Pełna lista limitów konta i tożsamości z dokumentacji:

EndpointMierzone naLimit
Wszystkie żądania APIIP3 000 na 5 minut
com.atproto.identity.updateHandlekonto10 na 5 minut, 50 na dobę
com.atproto.server.createAccountIP100 na 5 minut
com.atproto.server.createSessionkonto30 na 5 minut, 300 na dobę
com.atproto.server.deleteAccountIP50 na 5 minut
com.atproto.server.resetPasswordIP50 na 5 minut

Nieudane logowania są liczone osobno i znacznie surowiej, a dokumentacja w ogóle o tym nie wspomina. 10 września 2026 roku żądanie com.atproto.server.createSession do bsky.social z błędnymi danymi logowania zwróciło:

HTTP/2 401
ratelimit-limit: 10
ratelimit-remaining: 9
ratelimit-policy: 10;w=86400
 
{"error":"AuthenticationRequired","message":"Invalid identifier or password"}

Dwie kolejne nieudane próby obniżyły ratelimit-remaining do 8, a potem do 7, więc licznik działa na bieżąco. Okno 86 400 sekund to 24 godziny: dziesięć błędnych haseł na dobę wobec udokumentowanego limitu 300 dla createSession. Wystarczy zużyć dziesięć prób przy debugowaniu hasła aplikacji, by stracić dostęp do tego endpointu aż do znacznika czasu resetu, a w dokumentacji nie ma strony, która by to wyjaśniała.

Dokumentacja nie podaje też żadnego limitu dla com.atproto.server.refreshSession, czyli endpointu, którego dobrze napisany klient powinien używać zamiast createSession. Zapisz token odświeżania, odświeżaj sesję, a pułap 300 na dobę przestanie cię ograniczać.

Jak obejść pułap logowania
1
Wywołaj createSession raz. To wywołanie wlicza się do limitu 30 na 5 minut i 300 na dobę.
2
Zapisz token odświeżania. Przechowuj go zamiast hasła.
3
Odnawiaj sesję przez refreshSession. Nie loguj się ponownie.
4
Pułap 300 na dobę przestaje obowiązywać. refreshSession nie ma udokumentowanego limitu.
createSession szybko zużywa dobowy limit. refreshSession nie ma opublikowanego limitu.

Jakie nagłówki limitów faktycznie wysyła Bluesky?

Odpowiedzi PDS Bluesky zawierają cztery nagłówki: ratelimit-limit, ratelimit-remaining, ratelimit-reset i ratelimit-policy. Strona o limitach nigdy ich nie wymienia i stwierdza jedynie: "Many HTTP API services return rate limit headers on responses. Developers can use those to debug and understand the current limits, or even automate request throughput and backoff." Specyfikacja XRPC protokołu atproto wymienia jeden nagłówek, Retry-After, i to tylko jako opcjonalny dodatek do odpowiedzi 429.

Oto rzeczywista odpowiedź. Wywołanie com.atproto.server.describeServer do bsky.social 10 września 2026 roku zwróciło:

HTTP/2 200
ratelimit-limit: 3000
ratelimit-remaining: 2999
ratelimit-reset: 1789052966
ratelimit-policy: 3000;w=300

ratelimit-policy: 3000;w=300 to udokumentowane 3 000 na 5 minut zapisane jako limit i okno w sekundach, co potwierdza opublikowaną liczbę bezpośrednio z serwera. ratelimit-reset to uniksowy znacznik czasu, a nie liczba sekund oczekiwania, więc wstrzymaj żądania do tego momentu, zamiast usypiać proces na czas równy tej wartości.

To samo sprawdzenie dla public.api.bsky.app nie zwróciło żadnych nagłówków ratelimit-, co zgadza się z dokumentacją, która nazywa te endpointy "generous", nie podając żadnej liczby. Budżet punktów również nie pojawia się w żadnym nagłówku, bo nie jest przypisany do jednego endpointu. Musisz liczyć go samodzielnie.

Czy te limity dotyczą każdego konta na Bluesky?

Dotyczą kont hostowanych na instancjach PDS prowadzonych przez Bluesky. Dokumentacja jest w tej kwestii ostrożna: "Bluesky is built on top of an open network (atproto), and other providers in the network are likely to have different rate-limits." Samodzielnie hostowany PDS ustala własne wartości, a przekaźnik Bluesky nakłada osobny pułap na serwery federujące: 50 zdarzeń strumienia repozytorium na sekundę, 2 600 na godzinę i 21 000 na dobę.

Dokumentacja kończy się zdaniem "All of the limits described here are likely to evolve over time. Hopefully upwards!" Traktuj każdą liczbę z tego artykułu jako odczyt z 10 września 2026 roku i sprawdzaj nagłówki w czasie działania, zamiast zaszywać stałe w kodzie. Pamiętaj też, że docs.bsky.app przekierowuje teraz kodem 301 na bsky.network z zachowaniem ścieżki, więc aktualny adres cytowanej tu strony to https://bsky.network/docs/rate-limits.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Co to oznacza, jeśli planujesz posty na Bluesky za pomocą narzędzia?

Narzędzia do planowania podlegają temu samemu budżetowi co każdy inny klient, bo limity należą do Bluesky i do konta. Kolejka zaplanowanych postów wydaje 3 punkty na post z tych samych 35 000 na dobę, z których korzystają twoje ręczne polubienia i obserwacje. Narzędzie do planowania zmienia za to kształt wydatków: posty ustawione w kalendarzu wychodzą w odstępach, a nie falą, co utrzymuje cię poniżej stałego tempa, a nie tylko limitu godzinowego. AdaptlyPost obsługuje planowanie postów na Bluesky, a do tego planowanie zbiorcze i kalendarz treści, a wyniki pokazuje w analityce Bluesky. Publikacja tego samego materiału w kilku sieciach przez publikowanie na wielu kontach nadal kosztuje po stronie Bluesky 3 punkty, jednorazowo, bo to jeden rekord.

Najczęściej zadawane pytania

Ile postów na dobę może opublikować konto na Bluesky?

11 666 postów na dobę, z dobowego budżetu 35 000 punktów przy 3 punktach za CREATE. Przy równomiernym rozłożeniu na 24 godziny to 486 postów na godzinę, czyli jeden co 7,4 sekundy. Godzinowy pułap 1 666 postów to dopuszczalny skok, a siedmiokrotne jego osiągnięcie wyczerpuje całą dobę.

Czy polubienie wlicza się do tego samego limitu Bluesky co post?

Tak. Polubienie tworzy rekord app.bsky.feed.like, czyli operację CREATE wartą 3 punkty, tak samo jak post. Posty, polubienia, reposty i obserwacje czerpią z jednego godzinowego budżetu 5 000 punktów na konto.

Jaki status HTTP zwraca Bluesky po przekroczeniu limitu?

HTTP 429, opisany w dokumentacji jako "Too Many Requests." Specyfikacja XRPC protokołu atproto mówi, że odpowiedź 429 "may be a Retry-After header indicating a specific back-off time period." Na endpointach PDS sprawdź ratelimit-reset, aby poznać uniksowy znacznik czasu, w którym okno się zeruje.

Dlaczego logowanie na Bluesky nie działa już po kilku błędnych hasłach?

Nieudane wywołania com.atproto.server.createSession do bsky.social zwracają ratelimit-policy: 10;w=86400, czyli 10 prób na 24 godziny, z treścią błędu {"error":"AuthenticationRequired","message":"Invalid identifier or password"}. Tego limitu nie ma na stronie o limitach. Udokumentowane 30 na 5 minut i 300 na dobę dotyczą udanych sesji.

Czy grupowanie zapisów przez applyWrites oszczędza budżet limitu?

Oszczędza żądania HTTP, ale nie punkty. Dokumentacja podaje, że com.atproto.repo.applyWrites "can write to many records in a single API call" i że limity "sum up all of those individual record writes." Dwadzieścia pięć operacji CREATE w jednym wywołaniu kosztuje 75 punktów i jedno żądanie.

Czy limity Bluesky obowiązują na samodzielnie hostowanych serwerach PDS?

Opublikowane wartości dotyczą instancji PDS prowadzonych przez Bluesky. Inni dostawcy w atproto ustalają własne, jak ujmuje to dokumentacja: "likely to have different rate-limits." Przekaźnik Bluesky stosuje jednak własny pułap wobec każdego federującego PDS: 50 zdarzeń strumienia repozytorium na sekundę, 2 600 na godzinę i 21 000 na dobę, a domyślnie także maksymalnie 100 kont i 5 tworzonych na sekundę.

Ile kont Bluesky może korzystać z jednego IP, zanim trafi na limit żądań?

Dwadzieścia jeden kont zapisujących na pełnych obrotach za jednym adresem IP mieści się pod pułapem 3 000 żądań na pięć minut, z wynikiem 2 915 żądań. Dwudzieste drugie konto go przekracza, osiągając 3 054. Ten próg ujawnia się tylko wtedy, gdy kilka kont dzieli serwer, bo samo jedno konto zużywa 139 z 3 000 żądań.

Czy przesyłanie obrazów lub wideo zużywa budżet punktów?

Przesłanie bloba przez com.atproto.repo.uploadBlob kosztuje zero punktów, bo nie jest zapisem rekordu. Post z czterema obrazami wydaje 3 punkty na rekord posta i dodaje cztery żądania HTTP, po jednym na obraz, czyli łącznie pięć żądań. Budżet punktów obejmuje tylko operacje CREATE, UPDATE i DELETE na rekordach, a nie przesyłanie blobów.

Co tak naprawdę mówi nagłówek ratelimit-reset?

ratelimit-reset to uniksowy znacznik czasu oznaczający moment wyzerowania bieżącego okna, a nie liczba sekund oczekiwania. Odpowiedź com.atproto.server.describeServer z 10 września 2026 roku zawierała ratelimit-reset: 1789052966 obok ratelimit-limit: 3000 i ratelimit-remaining: 2999. Wstrzymaj żądania do tego momentu, zamiast usypiać proces na czas równy tej liczbie, i pamiętaj, że nagłówek Retry-After ze specyfikacji atproto to osobne, opcjonalne pole wysyłane tylko razem z odpowiedzią 429.

Jak często mogę zmieniać nazwę użytkownika na Bluesky, nie trafiając na limit?

com.atproto.identity.updateHandle ma limit 10 zmian na 5 minut i 50 na dobę na konto. To znacznie ciaśniej niż pułap 300 na dobę dla createSession, więc skrypt zmieniający nazwy według harmonogramu trafi na ten limit na długo przed wyczerpaniem budżetu zapisów.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły