Klucz API Notion: utwórz go, udostępnij strony, pierwsze żądanie
Klucz API Notion
Klucz API Notion: zdobądź token i wyślij pierwsze wywołanie | We.Inc
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)
- Element
- Wartość
- Bazowy URL
- Nagłówek uwierzytelniania
- Authorization: Bearer <token>
- Notion-Version (najnowsza)
- 2026-03-11, wymagana w każdym żądaniu
- Limit zapytań, większość planów
- 180 żądań na minutę, średnio 3 na sekundę
- Limit zapytań, Business i Enterprise
- 600 żądań na minutę, średnio 10 na sekundę
- Po przekroczeniu limitu
- HTTP 429 z kodem rate_limited i nagłówkiem Retry-After w sekundach
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.
- Otwórz Developer portal i utwórz nowe połączenie wewnętrzne dla swojego workspace'u; musisz być jego właścicielem.
- Otwórz ustawienia połączenia i skopiuj token API z karty Configuration. Przechowuj go w zmiennej środowiskowej, nie w kodzie.
- W Notion otwórz każdą stronę, z której ma korzystać połączenie, kliknij menu ••• w prawym górnym rogu, wybierz Add connections i wskaż swoje połączenie.
- Wysyłaj żądania z nagłówkiem Authorization: Bearer, nagłówkiem Notion-Version i Content-Type: application/json.
- Błąd dla strony, którą możesz otworzyć w Notion, zwykle oznacza, że strona nigdy nie została udostępniona połączeniu.
- Przypnij wartość Notion-Version w kodzie. Nowe wersje mogą zmieniać kształt odpowiedzi, a przypięcie utrzymuje stabilność aplikacji, dopóki sam nie zdecydujesz się na aktualizację.
- Limity zapytań to średnie na minutę. Kolejkuj zapisy, a przy 429 odczekaj liczbę sekund z Retry-After przed ponowną próbą.
- Nigdy nie umieszczaj tokena w kodzie front-endu. Wywołuj Notion z serwera lub funkcji serverless i pozwól przeglądarce komunikować się z nimi.
Najczęściej zadawane pytania
Gdzie znajdę swój klucz API Notion?
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 czy osobisty token dostępu?
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.
Dlaczego API twierdzi, że nie może znaleźć mojej strony?
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.
Jaki jest limit zapytań Notion API?
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.
Której wersji Notion-Version użyć?
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.
Jak znaleźć ID strony
- ID strony to 32 znaki szesnastkowe na końcu linku do strony Notion, po tytule. Poniższy kreator znajduje je we wklejonym linku i zapisuje w formie UUID z myślnikami, którą zwraca API.
Jak chronić token
- Każdy, kto ma token, może zrobić wszystko, na co połączenie ma pozwolenie na udostępnionych stronach. Trzymaj token w ustawieniach sekretów swojego hostingu i utwórz nowy, jeśli kiedykolwiek zostanie wklejony w publicznym miejscu.
Twoje pierwsze żądanie
Ustaw token raz w terminalu, a następnie wywołaj endpoint search. Bez zapytania zwraca każdą stronę udostępnioną połączeniu.
Terminal
Zastąp placeholder prawdziwym tokenem tylko we własnym terminalu, nigdy w pliku, który commitujesz.
notion.js (tylko serwer)
Zwykły fetch z serwera lub funkcji serverless, z prostym oczekiwaniem przy 429.
Kreator żądań Notion
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
Powiązane: Poradniki
- Ściągawka komend npm
- OAuth wyjaśniony
- Wypisanie jednym kliknięciem
- Tagi Open Graph w praktyce
- Frameworki open source do agentów AI
- Jak zoptymalizować obrazy na stronę internetową
- Szablon e-maila z potwierdzeniem zamówienia
- Strony osierocone
Produkt
Dla kogo
- Dla agencji
- Dla freelancerów
- Dla firm hostingowych
- Dla platform SaaS
- Dla startupów
- Usługi finansowe
- Rozwiązania dla ochrony zdrowia
Funkcje
Zasoby
- Blog
- Centrum pomocy
- Darmowe narzędzia dla firm
- Free UI Components
- Szablony
- Kolekcje szablonów
- Przykłady stron
- Poradniki
- Porównania
- Alternatywy
- Najlepsze
- Recenzje
- Przewodniki po cenach
- Zastosowania
- Słownik i poradniki
- Integracje
- Dla programistów
- Benchmark
- Windows App