Slider Endpoint
NEW v2.22.0 · Presentation Slides
Slider Endpoint
Manage all promotion slides ( slider and slider_description tables) via the JSON API: export, create, update, and delete.
Schema change starting with Shop 4.8: Starting with XONIC 4.8 (all versions after 4.7.15), the
slider table uses the polymorphic column pair entity_type (category / content / news) + entity_id instead of categories_id + content_id. The JSON payload accordingly uses `entity_type ` + `entity_id`; the new `news` type links slides to news articles. Homepage slider = `entity_type=content`, `entity_id=0`. Existing installations are automatically migrated via Self-Heal. API starting with v2.42.0.Endpoints
| Method | Endpoint | Scope | Description |
|---|---|---|---|
GET | /Export/JSON/sliders | slider:read | All Slides |
GET | /Export/JSON/slider/{id} | slider:read | Single Slide |
GET | /Export/JSON/sliders/{from}:{to} | slider:read | ID Range |
POST | /Import/JSON/slider | slider:write | Create New Slide |
PUT | /Import/JSON/slider | slider:write | Update slide (slider_id required) |
DELETE | /Delete/JSON/slider/{id} | slider:delete | Delete slide + all language variants |
Filter (Export)
?status=0|1— active / inactive slides only?type={n}— Slide type (0 = image, 1 = video, …)?categories_id={n}— Slides in a category (internally maps toentity_type=category)?content_id={n}— Slides on a CMS page (internally maps toentity_type=content)?language=de|en— only one language (ISO code orlanguage_id)
Payload Structure
{
"type": "slider",
"data": [
{
"slider_id": 11,
"slider_status": 1,
"sort_order": 100,
"entity_type": "content",
"entity_id": 0,
"target": "",
"type": 0,
"date_from": "2026-01-01",
"date_till": "2026-12-31",
"shop_ids": "1",
"languages": {
"de": {
"title": "Slide-Titel",
"description": "HTML
",
"direction": "left",
"width": 8,
"image": "images/slider/large/slide.png",
"image_mobile": "",
"video": "",
"video_mobile": ""
}
}
}
]
}Notes
- Starting with Shop 4.8:
entity_type(category/content/news) +entity_iddetermine the target object; clients that still sendcategories_id/content_idmust update their code (these fields are ignored). - PUT expects
slider_idin the payload; if it is missing, the API responds with a400 MISSING_IDerror. - A POST request with
a slider_idthat has already been assigned returnsa 409 Already existserror—use PUT in this case. - DELETE removes both the slide row and all associated
slider_description rows(all languages). - Background: Until now, slides could only be managed via the backend. This endpoint is suitable, for example, for correcting incorrect slide links after the fact using
PUT /slider.
