API — Strony (Pages)
Endpointy
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /cms/pages.json |
Lista stron |
| GET | /cms/pages/:code.json |
Szczegóły strony (po code lub id) |
| POST | /cms/pages.json |
Utworzenie strony |
| PATCH | /cms/pages/:code.json |
Aktualizacja strony |
| DELETE | /cms/pages/:code.json |
Usunięcie strony |
| GET | /cms/pages/:code/env.json |
Dane strony (env) |
Pola
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
name |
string | tak | Nazwa strony |
kind |
string | tak | Typ — text
|
path |
string | tak | Ścieżka URL (np. "" dla głównej, "about") |
site_code |
string | tak | Code witryny |
code |
string | nie | Unikalny kod (zalecany format: {site_code}-{path}) |
layout_code |
string | nie | Code szablonu |
page_code |
string | nie | Code strony nadrzędnej (parent) |
content |
string | nie | Treść strony (Liquid templates) |
paragraph_codes |
array | nie | Lista kodów paragrafów |
priority |
decimal | nie | Priorytet sortowania |
in_menu |
boolean | nie | Czy widoczna w menu (domyślnie: true) |
menu_code |
string | nie | Kod grupy menu (np. "top_menu", "footer_menu") |
redirect_to |
string | nie | URL przekierowania |
locale |
string | nie | Język strony (np. "pl", "en") |
knowledge_base_id |
integer | nie | ID bazy wiedzy do podłączenia |
html_title |
string | nie | Meta tytuł SEO |
html_description |
string | nie | Meta opis SEO |
html_keywords |
string | nie | Meta słowa kluczowe |
html_script |
string | nie | Dodatkowy skrypt HTML |
fields |
jsonb | nie | Własne pola (dostępne w Liquid) |
Podłączenie Bazy Wiedzy
Strona CMS może wyświetlać zawartość Bazy Wiedzy. Wystarczy podać knowledge_base_id przy tworzeniu/aktualizacji strony:
{
"page": {
"name": "Pomoc",
"kind": "text",
"path": "pomoc",
"site_code": "strona1",
"knowledge_base_id": 123
}
}
Po podłączeniu KB strona automatycznie renderuje widok bazy wiedzy pod ścieżką strony.
Filtrowanie i wyszukiwanie
-
?q=szukana_fraza— szuka w name, path, code -
?site_id=1— filtrowanie po witrynie -
?layout_id=2— filtrowanie po szablonie