Punto finale delle notizie

Endpoint

Notizie

Gestione degli articoli, delle categorie e degli autori della redazione.

Panoramica

Articoli di attualità (newsdesk)

Operazione	Metodo	Endpoint	Ambito
Esportazione	`GET`	`/xpanel/xoPort/export/json/newsdesk`	`news:read`
Import	`POST`	`/xpanel/xoPort/import/json/newsdesk`	`news:write`
Aggiornamento	`PUT`	`/xpanel/xoPort/import/json/newsdesk`	`news:write`
Elimina	`DELETE`	`/xpanel/xoPort/delete/json/newsdesk`	`news:delete`

Categorie di notizie (newsdesk_categories)

Operazione	Metodo	Endpoint	Ambito
Esportazione	`GET`	`/xpanel/xoPort/export/json/newsdesk_categories`	`news:read`
Import	`POST`	`/xpanel/xoPort/import/json/newsdesk_categories`	`news:write`
Elimina	`DELETE`	`/xpanel/xoPort/delete/json/newsdesk_categories`	`news:delete`

Autori (newsdesk_authors)

Operazione	Metodo	Endpoint	Ambito
Esportazione (tutto)	`GET`	`/xpanel/xoPort/export/json/newsdesk_authors`	`news:read`
Esportazione (singola)	`GET`	`/xpanel/xoPort/export/json/newsdesk_author/{id}`	`news:read`

Esporta articoli di notizie

Percorsi

Percorso	Risultato
`/export/json/newsdesks`	Tutti gli articoli
`/export/json/newsdesk/{id}`	Un solo articolo
`/export/json/newsdesks/{id}`	Tutti gli articoli a partire da questo ID

Parametri di query

Parametro	Tipo	Descrizione
`limit`	int	Numero massimo di record
`offset`	int	Posizione iniziale

Non esiste alcuna limitazione relativa alla categoria delle notizie a livello di server; a tal fine, valutare il campo categories_ids della risposta.

Elenco dei campi

Campi per articolo

Campo	Tipo	Descrizione
`newsdesk_id`	int	ID dell'articolo — campo obbligatorio per `PUT`
`newsdesk_status`	int	`1` = pubblicato, `0` = inattivo
`newsdesk_date_available`	datetime	Pubblicato a partire dal (`A-m-g H:i:s`)
`newsdesk_date_added`	datetime	Data di creazione
`newsdesk_last_modified`	datetime	Ultima modifica — solo esportazione
`newsdesk_sticky`	int	`1` = in evidenza
`sort_order`	int	Ordine di ordinamento
`newsdesk_image`	string	Immagine dell'articolo (nome file)
`newsdesk_author`	string	Autore come testo libero
`author_id`	int	Autore dalla gestione autori (`0` = nessuno)
`categories_ids`	int[]	Categorie delle notizie, ad es. `[2, 5]` — È possibile l'assegnazione multipla
`lingue{}`	object	Blocco lingua, chiave = codice lingua (`de`, `en` …)

A partire dalla v2.121.0, al momento della creazione (POST), l’importazione integra ogni lingua attiva per la quale non è stato inviato un blocco specifico, attingendo dalla lingua principale (il blocco de, altrimenti il primo blocco inviato). Se la traduzione DeepL è configurata, tradurrà queste lingue al prossimo ciclo.

Campi per lingua (nel blocco `languages`)

Campo	Tipo	Descrizione
`newsdesk_article_name`	stringa	Titolo
`newsdesk_article_shorttext`	html	Teaser / Testo breve
`newsdesk_article_description`	html	Testo dell'articolo
`newsdesk_image_text`	string	Didascalia immagine / Testo alternativo
`newsdesk_article_url`	string	Link esterno (facoltativo)
`newsdesk_article_url_name`	string	Etichetta del link esterno
`seo_name`	string	Slug dell'URL — viene generato dal titolo, se vuoto
`title_tag`	string	Meta titolo
`desc_tag`	stringa	Meta-descrizione
`tag_parole_chiave`	string	Parole chiave meta
`newsdesk_articolo_visualizzato`	int	Contatore delle visualizzazioni — solo esportazione

Importazione (POST) e aggiornamento (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"
        }
      }
    }]
  }'

Per un aggiornamento, inviare la stessa struttura tramite PUT specificando newsdesk_id. Verranno modificati solo i campi inviati; i campi non inviati rimarranno invariati.

Note

categories_ids è un aggiornamento completo: se il campo viene inviato, tutte le precedenti assegnazioni di categoria dell’articolo vengono sostituite. Se viene omesso, rimangono invariate.
L'assegnazione delle categorie si chiama categories_ids (array). Un newsdesk_categories_id viene ignorato come campo sconosciuto: l'articolo verrebbe creato senza categoria.
Se manca seo_name, lo slug viene generato automaticamente da newsdesk_article_name (strip_seo()).
Se seo_name cambia in seguito a un aggiornamento, l’importazione crea automaticamente un reindirizzamento 301 dal vecchio URL (cronologia SEO).
Dopo l’importazione, la cache delle notizie viene svuotata e le traduzioni DeepL degli articoli modificati vengono contrassegnate per una nuova traduzione.
Campi solo di esportazione (vengono ignorati durante l’importazione): newsdesk_last_modified, newsdesk_article_viewed.