API — Pliki (Assets)
Endpointy
| Metoda |
Ścieżka |
Opis |
| GET |
/cms/assets.json |
Lista plików |
| GET |
/cms/assets/:id.json |
Szczegóły pliku |
| POST |
/cms/assets.json |
Wgranie pliku |
| PATCH |
/cms/assets/:id.json |
Aktualizacja |
| DELETE |
/cms/assets/:id.json |
Usunięcie |
| GET |
/cms/assets/:id/view |
Pobranie pliku (zwraca surowy plik) |
| GET |
/cms/assets/view/*name |
Pobranie po nazwie |
Foldery
| Metoda |
Ścieżka |
Opis |
| POST |
/cms/assets/create_folder |
Utworzenie folderu |
| DELETE |
/cms/assets/destroy_folder |
Usunięcie folderu |
Pola
| Pole |
Typ |
Wymagane |
Opis |
name |
string |
tak |
Nazwa pliku (unikalna w ramach konta) |
kind |
string |
auto |
Typ: image, css, js, zip (auto-detect z rozszerzenia) |
file |
file |
nie |
Plik do wgrania (multipart) |
content |
string |
nie |
Treść tekstowa (dla CSS/JS/HTML) |
folder_id |
integer |
nie |
ID folderu |
site_id |
integer |
nie |
ID witryny |
layout_id |
integer |
nie |
ID szablonu |
fields |
jsonb |
nie |
Własne pola |
Import ZIP
Wgranie pliku ZIP z kind: "zip" automatycznie rozpakuje archiwum i utworzy strukturę folderów z plikami.
URL pliku
Po wgraniu asset dostępny jest pod polem s3_url (bezpośredni link S3) w odpowiedzi JSON.
Filtrowanie
-
?q=fraza — szuka w name
-
?site_id=1 — filtrowanie po witrynie
-
?folder_id=5 — filtrowanie po folderze
-
?kind=image — filtrowanie po typie