Categorie Endpoint

Parametri di query

v2.122.12 Lo spazio vuoto ai margini non conta; un valore vuoto significa «non impostato»: ?parent_id=5%00 restituisce i figli di 5 (fino alla v2.122.11 il filtro non era presente e veniva restituito l’intero albero), così come status e recursive; ?language=%20 restituisce tutte le lingue (finora un elenco vuoto).

NOVITÀ v2.122.11 Indirizzo del negozio → Categoria: ?seo_string= cerca esattamente l’intero percorso così come viene fornito dal negozio, senza host e senza il segmento di lingua lng/xx/ (in compenso ?language=xx, senza il parametro, in tutte le lingue); le barre esterne non hanno importanza. In caso di più risultati, vengono restituiti tutti; se due categorie condividono un indirizzo, il negozio effettua la selezione senza un ordine prestabilito e il primo risultato non è necessariamente la pagina che restituisce. Il filtro funziona anche con parent_id e status; su /categories/{id} restituisce un errore HTTP 400 FILTER_NOT_APPLICABLE. Fino alla versione v2.122.10, il nome veniva ignorato come UNKNOWN_FILTER e veniva restituita l’intera struttura.

# Kategorie zu https://shop.de/lng/en/fishing-rods/spinning-rods/
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://shop.de/xpanel/xoport/export/json/categories?seo_string=fishing-rods/spinning-rods&language=en"

Regole e casi di errore: API di esportazione; passo dopo passo dall’indirizzo all’ID: SEO History.

Campi della risposta

• categories_id - ID univoco
• parent_id - Categoria padre (0 = radice)
• status - Attivo (1) o inattivo (0)
• sort_order - Ordine di ordinamento
• restricted_customer_groups - ID dei gruppi di clienti che non vedono la categoria; [] se nessun gruppo è bloccato. Presente in ogni categoria (dalla v2.47.0). Se l'importazione blocca una categoria principale, blocca anche le sue sottocategorie attive per quel gruppo; queste appariranno quindi anch'esse qui
• categories_image, header_category, header_nav_template, template, sitemap, shop_ids, hide_subcategory_tiles, hide_page_title, show_last_modified, redirect_type, redirect_url, subs_block, tree_block - Impostazioni della categoria, presenti nell’importazione con lo stesso nome
• date_added, last_modified, tagcloud, lft, rgt, path - solo in lettura
• languages{} - Per lingua: categories_name, categories_heading, categories_short_description, categories_description, title_tag, desc_tag, keywords_tag, seo_name, seo_text, oltre a categories_id, language_id e language_code; di sola lettura seo_string (indirizzo della categoria) e cpath

Le colonne della categoria vengono riportate così come sono gestite dal negozio; una colonna che non è ancora presente in un'installazione precedente non compare nella risposta.

Richiesta di esempio

curl -X POST "https://shop.de/xpanel/xoport/import/json/categories" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "categories",
    "data": [{
      "parent_id": 0,
      "status": 1,
      "sort_order": 10,
      "languages": {
        "de": {
          "categories_name": "Neue Kategorie",
          "categories_heading": "Neue Kategorie Überschrift"
        }
      }
    }]
  }'

curl -X DELETE "https://shop.de/xpanel/xoport/delete/json/categories/99" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Attenzione: viene eliminata solo una categoria vuota. Se contiene sottocategorie o prodotti, il negozio risponde con HTTP 409 (HAS_SUBCATEGORIES o HAS_PRODUCTS) e non elimina nulla. L’ID è presente nel percorso; senza di esso, ad esempio con ?categories_id=, viene restituito un errore HTTP 400 MISSING_ID.

{
  "success": true,
  "api_version": "2.122.12",
  "type": "categories_productlist",
  "data": [
    {
      "categories_id": 73,
      "categories_name": "Drucker",
      "products_count": 3,
      "products": [
        { "id": 101, "model": "HP-LJ-4050" },
        { "id": 102, "model": "EP-WF-7840" },
        { "id": 103, "model": "BR-HL-L6400" }
      ]
    }
  ],
  "stats": {
    "total": 1,
    "count": 1,
    "timestamp": "2026-10-18 14:00:00"
  }
}

La navigazione avviene come nell’elenco delle categorie: senza limit, vengono visualizzate fino a 250 categorie; se ce ne sono di più, vengono visualizzate le prime 50 e stats.has_more; con limit e offset, come di consueto.