Zdobądź klucz API Notion jako token połączenia wewnętrznego lub osobisty token dostępu, udostępnij mu strony, ustaw nagłówek Notion-Version i wyślij pierwsze żądanie.
Klucz API Notion to token, który Twój kod wysyła do Notion API. Utwórz połączenie wewnętrzne w Developer portal Notion i skopiuj jego token API z karty Configuration, a następnie udostępnij połączeniu każdą stronę. Każde żądanie wymaga tego tokena jako wartości Bearer oraz nagłówka Notion-Version.
Podstawy Notion API (developers.notion.com, październik 2026)
Połączenie Notion ze stroną, formularzem lub agentem zaczyna się od jednego tokena. Notion daje dwa sposoby, by go zdobyć: połączenie wewnętrzne, które widzi tylko udostępnione mu strony, oraz osobisty token dostępu, który działa w Twoim imieniu. Wklej poniżej link do strony, a ta strona zbuduje dla niego gotowe do uruchomienia żądanie, z tokenem jako placeholderem.
W przypadku połączenia wewnętrznego otwórz je w Developer portal i poszukaj tokena API na karcie Configuration. Osobisty token dostępu jest pokazywany tylko raz podczas tworzenia, więc skopiuj go od razu.
Połączenie wewnętrzne jest powiązane z jednym workspace'em i sięga tylko do udostępnionych mu stron, co pasuje do strony lub automatyzacji. Osobisty token dostępu uwierzytelnia jako Ty. Połączenia publiczne używają zamiast tego OAuth, dla aplikacji instalowanych przez inne workspace'y.
Notion wymaga, by każda strona została ręcznie udostępniona połączeniu, zanim będzie ono mogło ją odczytać lub zapisać. Użyj Add connections w menu ••• strony i spróbuj ponownie.
Według stanu na październik 2026 Notion podaje 180 żądań na minutę (około 3 na sekundę) w większości planów i 600 na minutę w Business i Enterprise. Nadmiarowe żądania dostają HTTP 429 z kodem rate_limited.
Strona o wersjonowaniu Notion wskazuje 2026-03-11 jako najnowszą wersję. Nagłówek jest wymagany we wszystkich żądaniach REST API; oficjalne SDK ustawia go za Ciebie.
Ustaw token raz w terminalu, a następnie wywołaj endpoint search. Bez zapytania zwraca każdą stronę udostępnioną połączeniu.
Zastąp placeholder prawdziwym tokenem tylko we własnym terminalu, nigdy w pliku, który commitujesz.
Zwykły fetch z serwera lub funkcji serverless, z prostym oczekiwaniem przy 429.
Wklej link do strony Notion lub jej ID i wybierz, co zrobić. Żądanie używa $NOTION_API_KEY, więc najpierw ustaw tę zmienną w terminalu. Nic nie opuszcza Twojej przeglądarki.
Żądanie
Odczytaj właściwości strony
Odczytaj bloki treści strony
Szukaj udostępnionych stron po tytule
Link do strony Notion lub ID
Szukane słowa
ID strony: {v}
W tym tekście nie znaleziono jeszcze 32-znakowego ID strony.
Kopiuj żądanie
Skopiowano
Zacznij za darmo · Bez karty kredytowej