Point d'accès aux actualités

Point d'extrémité

Actualités

Gérer les articles, les catégories et les auteurs de Newsdesk.

Aperçu

Articles d'actualité (Newsdesk)

Opération	Méthode	Point d'extrémité	Portée
Exportation	`GET`	`/xpanel/xoPort/export/json/newsdesk`	`news:read`
Import	`POST`	`/xpanel/xoPort/import/json/newsdesk`	`news:write`
Mise à jour	`PUT`	`/xpanel/xoPort/import/json/newsdesk`	`news:write`
Supprimer	`DELETE`	`/xpanel/xoPort/delete/json/newsdesk`	`news:delete`

Catégories d'actualités (newsdesk_categories)

Opération	Méthode	Point de terminaison	Portée
Exportation	`GET`	`/xpanel/xoPort/export/json/newsdesk_categories`	`actualités : lecture`
Import	`POST`	`/xpanel/xoPort/import/json/newsdesk_categories`	`news:write`
Supprimer	`DELETE`	`/xpanel/xoPort/delete/json/newsdesk_categories`	`news:delete`

Auteurs (newsdesk_authors)

Opération	Méthode	Point de terminaison	Portée
Exportation (tout)	`GET`	`/xpanel/xoPort/export/json/newsdesk_authors`	`news:read`
Exportation (individuelle)	`GET`	`/xpanel/xoPort/export/json/newsdesk_author/{id}`	`news:read`

Exporter des articles d'actualité

Itinéraires

Itinéraire	Résultat
`/export/json/newsdesks`	Tous les articles
`/export/json/newsdesk/{id}`	Un seul article
`/export/json/newsdesks/{id}`	Tous les articles à partir de cet ID

Paramètres de requête

Paramètres	Type	Description
`limit`	int	Nombre maximal d'enregistrements
`offset`	int	Position de départ

Il n'y a pas de restriction côté serveur concernant la catégorie d'actualités — pour cela, il faut analyser le champ categories_ids de la réponse.

Liste des champs

Champs par article

Champ	Type	Description
`newsdesk_id`	int	ID de l'article — champ obligatoire pour la requête `PUT`
`newsdesk_status`	int	`1` = publié, `0` = inactif
`newsdesk_date_available`	datetime	Publié à partir de (`A-m-j H:i:s`)
`newsdesk_date_added`	datetime	Date de création
`newsdesk_last_modified`	datetime	Dernière modification — exportation uniquement
`newsdesk_sticky`	int	`1` = épinglé en haut
`sort_order`	int	Ordre de tri
`newsdesk_image`	chaîne	Image de l'article (nom de fichier)
`newsdesk_author`	chaîne	Auteur (texte libre)
`author_id`	int	Auteur issu de la gestion des auteurs (`0` = aucun)
`categories_ids`	int[]	Catégories d'actualités, par exemple `[2, 5]` — plusieurs attributions possibles
`languages{}`	object	Bloc de langue, clé = code de langue (`de`, `en` …)

Depuis la v2.121.0 Lors de la création (POST), l’importation complète chaque langue active pour laquelle aucun bloc spécifique n’a été envoyé, à partir de la langue principale (le bloc « de », ou sinon le premier bloc envoyé). Si la traduction DeepL est configurée, elle traduira ces langues lors de la prochaine exécution.

Champs par langue (dans le bloc « `languages` »)

Champ	Type	Description
`newsdesk_article_name`	chaîne	Titre
`newsdesk_article_shorttext`	html	Teaser / Texte court
`newsdesk_article_description`	html	Texte de l'article
`newsdesk_image_text`	chaîne	Légende / Texte alternatif
`newsdesk_article_url`	string	Lien externe (facultatif)
`newsdesk_article_url_name`	chaîne	Libellé du lien externe
`seo_name`	chaîne	Slug de l'URL — généré à partir du titre s'il est vide
`title_tag`	chaîne	Méta-titre
`desc_tag`	chaîne	Méta-description
`balise_mots-clés`	chaîne	Mots-clés méta
`article_vu_par_la_rédaction`	int	Compteur de visites — exportation uniquement

Importation (POST) et mise à jour (PUT)

curl -X POST "https://shop.de/xpanel/xoPort/import/json/newsdesk" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "newsdesk",
    "data": [{
      "newsdesk_status": 1,
      "newsdesk_sticky": 0,
      "sort_order": 0,
      "newsdesk_date_available": "2026-08-12 08:00:00",
      "author_id": 0,
      "categories_ids": [2],
      "languages": {
        "de": {
          "newsdesk_article_name": "Neue Produktlinie",
          "newsdesk_article_shorttext": "Kurz angerissen …",
          "newsdesk_article_description": "Wir erweitern …",
          "title_tag": "Neue Produktlinie | Shop",
          "desc_tag": "Wir erweitern unser Sortiment."
        },
        "en": {
          "newsdesk_article_name": "New product line"
        }
      }
    }]
  }'

Pour une mise à jour, envoyez la même structure via PUT en précisant le newsdesk_id. Seuls les champs transmis sont modifiés — les champs non envoyés restent inchangés.

Remarques

categories_ids est un miroir complet : si le champ est envoyé, toutes les affectations de catégories précédentes de l’article sont remplacées. S’il est omis, elles restent inchangées.
L'affectation de catégories s'appelle categories_ids (tableau). Un newsdesk_categories_id est ignoré car considéré comme un champ inconnu — l'article serait alors créé sans catégorie.
Si seo_name est absent, le slug est généré automatiquement à partir de newsdesk_article_name (strip_seo()).
Si seo_name change lors d’une mise à jour, l’importation crée automatiquement une redirection 301 depuis l’ancienne URL (historique SEO).
Après l’importation, le cache des actualités est vidé et les traductions DeepL des articles modifiés sont marquées pour être retraduites.
Champs réservés à l’exportation (ignorés lors de l’importation) : newsdesk_last_modified, newsdesk_article_viewed.