Slider-Endpunkt

NEU v2.22.0 · Promotion-Slides

Slider Endpoint

Verwalten Sie alle Promotion-Slides (Tabelle slider + slider_description) per JSON-API: exportieren, anlegen, aktualisieren und löschen.

Schema-Änderung ab Shop 4.8: Ab XONIC 4.8 (alles nach Release 4.7.15) nutzt die Tabelle slider das polymorphe Spaltenpaar entity_type (category / content / news) + entity_id statt categories_id + content_id. Das JSON-Payload führt entsprechend entity_type + entity_id; der neue Typ news verknüpft Slides mit News-Artikeln. Startseiten-Slider = entity_type=content, entity_id=0. Bestehende Installationen migrieren automatisch per Self-Heal. API ab v2.42.0.

Endpoints

Methode	Endpoint	Scope	Beschreibung
`GET`	`/Export/JSON/sliders`	`slider:read`	Alle Slides
`GET`	`/Export/JSON/slider/{id}`	`slider:read`	Einzelne Slide
`GET`	`/Export/JSON/sliders/{from}:{to}`	`slider:read`	ID-Range
`POST`	`/Import/JSON/slider`	`slider:write`	Neue Slide anlegen
`PUT`	`/Import/JSON/slider`	`slider:write`	Slide aktualisieren (slider_id Pflicht)
`DELETE`	`/Delete/JSON/slider/{id}`	`slider:delete`	Slide + alle Sprachvarianten löschen

Filter (Export)

?status=0|1 — nur aktive / inaktive Slides
?type={n} — Slide-Typ (0 = Bild, 1 = Video, …)
?categories_id={n} — Slides einer Kategorie (mappt intern auf entity_type=category)
?content_id={n} — Slides einer CMS-Seite (mappt intern auf entity_type=content)
?language=de|en — nur eine Sprache (ISO-Code oder language_id)

Payload-Struktur

{
  "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": "<p>HTML</p>",
          "direction": "left",
          "width": 8,
          "image": "images/slider/large/slide.png",
          "image_mobile": "",
          "video": "",
          "video_mobile": ""
        }
      }
    }
  ]
}

Hinweise

Ab Shop 4.8: entity_type (category / content / news) + entity_id bestimmen das Zielobjekt; Clients, die noch categories_id/content_id senden, müssen umstellen (diese Felder werden ignoriert).
PUT erwartet slider_id im Payload; fehlt sie, antwortet die API mit 400 MISSING_ID.
POST mit bereits vergebener slider_id liefert 409 Already exists — in diesem Fall PUT verwenden.
DELETE entfernt sowohl die Slide-Row als auch alle zugehörigen slider_description-Zeilen (alle Sprachen).
Hintergrund: Slides waren bisher nur per Backend pflegbar. Der Endpoint eignet sich z. B. für das nachträgliche Korrigieren falscher Slide-Links per PUT /slider.