Wszystkie 15 zakresów dla kluczy API i połączeń AI: na co pozwala każdy zakres, jak nazywa się w panelu i czego nie może zrobić żaden klucz API.
Zakresy określają, co może robić klucz API. Te same 15 zakresów obowiązuje też dla asystentów AI, których łączysz przez MCP. Zawsze wybieraj tylko te zakresy, których aplikacja naprawdę potrzebuje.
Podstawowe zasady
- Każdy endpoint wymaga dokładnie jednego zakresu
- Dla kluczy API write:X automatycznie obejmuje read:X – panel informuje o tym tekstem „write:X automatycznie obejmuje read:X”
- Jeśli brakuje zakresu, API odpowiada kodem 403 insufficient_scope i podaje potrzebny zakres w details.required_scope
- Endpointy, które w ogóle nie są dostępne dla kluczy API, również odpowiadają kodem 403 insufficient_scope
- Funkcje właściciela i admina, takie jak członkowie, płatności czy zarządzanie domenami, nie są dostępne z żadnym zakresem
Wszystkie zakresy
W oknie „Utwórz nowy klucz API” wybierasz dla każdego obszaru „Odczyt” lub „Zapis”; lista kluczy pokazuje nazwy zakresów z pierwszej kolumny. Forma „Odczyt · Strony” pojawia się na stronie zgody dla aplikacji AI i w karcie „Połączone aplikacje”.
| Zakres | Dla aplikacji AI | Pozwala na |
|---|---|---|
| read:pages | Odczyt · Strony | Listę i odczyt stron, odczyt i walidację wersji roboczej, listę bloków, odczyt SEO, listę wersji, pobieranie typów bloków |
| write:pages | Zapis · Strony | Tworzenie i edycję stron (w tym handle), edycję wersji roboczej, tworzenie, edycję, usuwanie i zmianę kolejności bloków, edycję SEO, widoczność, publikowanie, przywracanie wersji, linki z zaproszeniem do prywatnych stron |
| read:links | Odczyt · Linki | Listę i odczyt linków strony |
| write:links | Zapis · Linki | Tworzenie, edycję, usuwanie i zmianę kolejności linków |
| read:assets | Odczyt · Pliki | Listę plików |
| write:assets | Zapis · Pliki | Przesyłanie i usuwanie plików, przesyłanie plików dla strony |
| read:forms | Odczyt · Formularze | Odczyt formularzy, podsumowanie, listę zgłoszeń i ich eksport do CSV (eksport od planu Creator Pro) |
| write:forms | Zapis · Formularze | Tworzenie, edycję i usuwanie formularzy |
| read:stats | Odczyt · Statystyki | Statystyki stron i workspace (podsumowanie, szereg czasowy, porównanie, linki, widżety, konwersje, najlepsze strony), historię push i wykorzystanie push |
| read:workspaces | Odczyt · Workspace’y | Odczyt funkcji planu, wykorzystania, listy członków i ustawień workspace, listę domen, listę i odczyt szablonów, listę i odczyt sekretów callbacków (bez sekretu w postaci jawnej) |
| write:workspaces | Zapis · Workspace’y | Obecnie brak endpointów poza read:workspaces |
| read:donations | Odczyt · Wpłaty wspierających | Sumy wpłat wspierających w workspace (wpłaty przez blok „Wesprzyj”) |
| read:short_links | Odczyt · Krótkie linki | Listę i odczyt krótkich linków |
| write:short_links | Zapis · Krótkie linki | Tworzenie, edycję i usuwanie krótkich linków |
| write:templates | Zapis · Szablony workspace | Tworzenie, edycję i usuwanie własnych szablonów workspace (odczytuje się je z read:workspaces), zobacz Własne szablony |
Które endpointy dokładnie należą do którego zakresu, pokazuje artykuł Endpointy API według obszarów.
Czego nie może zrobić żaden klucz API
- Usuwać stron
- Tworzyć linków podglądu wersji roboczej
- Pobierać podziału statystyk według urządzenia, kraju, źródła wejścia i UTM
- Wysyłać powiadomień push ani zarządzać regułami push
- Łączyć ani rozłączać integracji
- Zarządzać webhookami
- Dodawać, weryfikować, aktywować, dezaktywować ani usuwać domen
- Zarządzać członkami, zaproszeniami i rolami ani przekazywać własności
- Zmieniać ustawień workspace ani płatności
- Tworzyć, edytować, zmieniać ani usuwać sekretów callbacków
- Odczytywać listy wpłat wspierających, obsługiwać wniosków o dostęp do danych ani anonimizować zgłoszeń formularzy
- Zarządzać Twoim profilem, obserwowanymi stronami ani samymi kluczami API
Te rzeczy robisz w panelu.
Zakresy dla asystentów AI
Przy połączeniu MCP wybierasz te same zakresy na stronie zgody. Są dwie różnice: po pierwsze, uprawnienie do zapisu nie obejmuje tam uprawnienia do odczytu – więc przyznaj oba. Po drugie, Twoja rola ogranicza wybór: czytelnicy dostają tylko uprawnienia do odczytu (bez formularzy i krótkich linków), a redaktorzy wszystko oprócz „Zapis · Workspace’y”, krótkich linków i szablonów workspace. Więcej w artykule Asystenci AI: uprawnienia, bezpieczeństwo i limity.
Zalecane kombinacje
| Zastosowanie | Zakresy |
|---|---|
| Raporty i dashboardy | read:stats, read:pages |
| Synchronizacja linków z CMS lub sklepu | write:links, read:pages |
| Automatyczne utrzymywanie i publikowanie stron | write:pages, write:links |
| Linki kampanii z CRM | write:short_links |
| Przekazywanie leadów z formularzy do CRM | read:forms |
| Wdrażanie szablonów z pipeline’u CI | write:templates, read:workspaces |
Może Ci się też przydać
Nic nie znaleziono?
Napisz, czego potrzebujesz, a nasz zespół pomocy technicznej pomoże Ci osobiście.