API Delete: eliminare record con DELETE

L'ID è presente nel percorso (/{entity}/{id}). Senza di esso, ad esempio con ?products_id=42, lo shop risponde con un errore HTTP 400 MISSING_ID e non elimina nulla; i parametri di query sconosciuti vengono ignorati. Senza ID nel percorso, vengono eliminati solo i contenuti multimediali, la cronologia SEO, gli iscritti alla newsletter e i contratti, tramite filtri o un payload JSON. In assenza di entrambi, viene restituito un errore HTTP 400 (NO_TARGETS, MISSING_FILTER o MISSING_DATA).

Inviare l’ID come numero intero senza caratteri residui, cifre decimali o segno. La verifica rigorosa del segmento di percorso, presente nell’esportazione dalla v2.122.12 (vedi API di esportazione), non si applica alla funzione di eliminazione.

• Un valore vuoto o solo uno spazio significa «non impostato». A partire dalla versione v2.122.12, gli spazi ai margini non vengono conteggiati: l’eliminazione avviene in base al valore verificato. Nei negozi precedenti alla versione 4.9.173, inviare valori senza spazi ai margini e omettere i parametri vuoti. I valori validi senza spazi ai margini funzionano come prima.
• A differenza dell’esportazione, l’endpoint Delete ignora i nomi dei parametri sconosciuti.
• A partire dalla versione v2.122.11, il filtro degli indirizzi seo_string funziona solo con il metodo GET. È possibile trovare le voci relative a un vecchio indirizzo tramite GET /Export/JSON/seohistorys?seo_string=… ed eliminarle tramite il loro sh_id: DELETE /Delete/JSON/seohistory/{sh_id} oppure con il tronco {"type": "seohistory", "data": [{"sh_id": …}]}. Fino alla v2.122.10 il nome veniva ignorato e l’eliminazione avveniva esclusivamente in base a type e base_id; con ?type=p venivano quindi eliminate tutte le voci relative ai prodotti.

DELETE /Delete/JSON/seohistorys?type=p&base_id=abc

HTTP 400
{
  "success": false,
  "api_version": "2.122.12",
  "error": {
    "code": "INVALID_FILTER_VALUE",
    "message": "One or more query parameter values could not be used. Nothing was deleted — see \"details\"."
  },
  "details": [
    { "param": "base_id", "message": "Value \"abc\" is not an integer." }
  ]
}

Prima dell'aggiornamento, verificare se la propria connessione invia valori contenenti spazi, interruzioni di riga o %00 ai margini, ad esempio da un file importato: tali valori vengono ora considerati così come appaiono senza questi caratteri.

Cancellazione riuscita

{
  "success": true,
  "api_version": "2.122.12",
  "type": "newsdesk",
  "deleted_id": 23,
  "details": {
    "newsdesk_id": 23,
    "newsdesk_article_name": "Gelöschter Artikel"
  },
  "timestamp": "2026-10-18 14:00:00"
}

Cancellazione bloccata

{
  "success": false,
  "api_version": "2.122.12",
  "error": {
    "code": "HAS_SUBCATEGORIES",
    "message": "Cannot delete newsdesk category \"Shopnews\" (ID: 1): Has 3 sub-categories. Delete them first."
  }
}