Punto finale dello slider

NOVITÀ v2.22.0 · Diapositive promozionali

Endpoint dello slider

Gestisci tutte le diapositive promozionali (tabella slider + slider_description) tramite API JSON: esporta, crea, aggiorna ed elimina.

Modifica dello schema a partire da Shop 4.8: a partire da XONIC 4.8 (tutte le versioni successive alla 4.7.15), la tabella slider utilizza la coppia di colonne polimorfiche entity_type (category / content / news) + entity_id invece di categories_id + content_id. Il payload JSON contiene di conseguenza entity_type + entity_id; il nuovo tipo news collega le diapositive agli articoli di notizie. Slider della pagina iniziale = entity_type=content, entity_id=0. Le installazioni esistenti vengono migrate automaticamente tramite Self-Heal. API a partire dalla v2.42.0.

Endpoint

Metodo	Endpoint	Ambito	Descrizione
`GET`	`/Export/JSON/sliders`	`slider:read`	Tutte le diapositive
`GET`	`/Esporta/JSON/slider/{id}`	`slider:read`	Singola diapositiva
`GET`	`/Export/JSON/sliders/{from}:{to}`	`slider:read`	Intervallo di ID
`POST`	`/Import/JSON/slider`	`slider:write`	Crea nuova diapositiva
`PUT`	`/Import/JSON/slider`	`slider:write`	Aggiorna diapositiva (slider_id obbligatorio)
`DELETE`	`/Elimina/JSON/slider/{id}`	`slider:delete`	Elimina slide + tutte le varianti linguistiche

Filtro (Esportazione)

?status=0|1 — solo slide attive / inattive
?type={n} — Tipo di slide (0 = immagine, 1 = video, …)
?categories_id={n} — Slide di una categoria (mappato internamente su entity_type=category)
?content_id={n} — diapositive di una pagina CMS (mappate internamente su entity_type=content)
?language=de|en — una sola lingua (codice ISO o language_id)

Struttura del payload

{
  "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": ""
        }
      }
    }
  ]
}

Note

A partire dalla versione 4.8 di Shop: entity_type (category / content / news) + entity_id determinano l'oggetto di destinazione; i client che inviano ancoracategories_id/content_id devono adeguarsi (questi campi vengono ignorati).
Il metodo PUT richiede lo slider_id nel payload; se manca, l’API risponde con 400 MISSING_ID.
Un POST con uno slider_id già assegnato restituisce il codice di errore 409 Already exists — in questo caso utilizzare PUT.
DELETE rimuove sia la riga della diapositiva che tutte le righe slider_description associate (in tutte le lingue).
Contesto: finora le slide potevano essere gestite solo tramite il backend. L’endpoint è adatto, ad esempio, per correggere a posteriori link errati delle slide tramite PUT /slider.