Point d'extrémité du curseur

NOUVEAU v2.22.0 · Diapositives de promotion

Point de terminaison des diapositives

Gérez toutes les diapositives promotionnelles (tables slider + slider_description) via l'API JSON : exportez, créez, mettez à jour et supprimez.

Modification du schéma à partir de la version 4.8 de Shop : à partir de XONIC 4.8 (toutes les versions postérieures à la version 4.7.15), la table « slider » utilise la paire de colonnes polymorphes « entity_type » (category / content / news) + « entity_id » au lieu de « categories_id » + « content_id ». La charge utile JSON contient donc entity_type + entity_id; le nouveau type « news » relie les diapositives aux articles d’actualité. Slider de la page d’accueil = entity_type=content, entity_id=0. Les installations existantes sont migrées automatiquement via la fonctionnalité Self-Heal. API à partir de la version 2.42.0.

Points de terminaison

Méthode	Point de terminaison	Portée	Description
`GET`	`/Export/JSON/sliders`	`slider:read`	Toutes les diapositives
`GET`	`/Export/JSON/slider/{id}`	`slider:read`	Diapositive individuelle
`GET`	`/Export/JSON/sliders/{from}:{to}`	`slider:read`	Plage d'identifiants
`POST`	`/Import/JSON/slider`	`slider:write`	Créer une nouvelle diapositive
`PUT`	`/Import/JSON/slider`	`slider:write`	Mettre à jour une diapositive (slider_id obligatoire)
`DELETE`	`/Delete/JSON/slider/{id}`	`slider:delete`	Supprimer la diapositive et toutes ses variantes linguistiques

Filtre (exportation)

?status=0|1 — uniquement les diapositives actives / inactives
?type={n} — type de diapositive (0 = image, 1 = vidéo, …)
?categories_id={n} — diapositives d’une catégorie (mappé en interne sur entity_type=category)
?content_id={n} — diapositives d’une page CMS (correspond en interne à entity_type=content)
?language=de|en — une seule langue (code ISO ou language_id)

Structure de la charge utile

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

Remarques

À partir de la version 4.8 de Shop : entity_type (category / content / news) + entity_id déterminent l’objet cible ; les clients qui envoient encorecategories_id/content_id doivent s’adapter (ces champs sont ignorés).
La méthode PUT attend un slider_id dans la charge utile ; s’il manque, l’API renvoie un code d’erreur 400 MISSING_ID.
Une requête POST avec un slider_id déjà attribué renvoie le code d'erreur 409 Already exists — dans ce cas, utilisez la méthode PUT.
La méthode DELETE supprime à la fois la ligne de diapositive et toutes les lignes slider_description associées (toutes langues confondues).
Contexte : jusqu’à présent, les diapositives ne pouvaient être gérées que via le backend. Ce point de terminaison est notamment utile pour corriger a posteriori des liens de diapositives erronés via PUT /slider.