API Delete : supprimer des enregistrements à l'aide de la commande DELETE

L'ID figure dans le chemin d'accès (/{entity}/{id}). Sans celui-ci, par exemple avec ?products_id=42, la boutique renvoie une réponse HTTP 400 MISSING_ID et ne supprime rien ; elle ignore alors silencieusement les paramètres de requête inconnus. Sans ID dans le chemin d’accès, seuls les médias, l’historique SEO, les abonnés à la newsletter et les contrats peuvent être supprimés, via des filtres ou un corps JSON. En l’absence de ces deux éléments, une erreur HTTP 400 est renvoyée (NO_TARGETS, MISSING_FILTER ou MISSING_DATA).

Envoyez l’ID sous forme de nombre entier, sans caractère supplémentaire, sans décimales ni signe. La validation stricte du segment de chemin, présente dans l’exportation depuis la version v2.122.12 (voir API d’exportation), ne s’applique pas à la suppression.

• Une valeur vide ou un espace seul signifie « non défini ». Depuis la version v2.122.12, les espaces en bordure ne sont plus pris en compte : la suppression s'effectue après la valeur vérifiée. Dans les boutiques antérieures à la version 4.9.173, envoyez des valeurs sans espace à la fin et omettez les paramètres vides. Les valeurs valides sans espace à la fin fonctionnent comme auparavant.
• Contrairement à l’exportation, le point de terminaison « Delete » ignore les noms de paramètres inconnus.
• Depuis la version v2.122.11, le filtre d’adresse seo_string ne fonctionne qu’avec la méthode GET. Vous pouvez retrouver les entrées correspondant à une ancienne adresse via GET /Export/JSON/seohistorys?seo_string=… et les supprimer via leur sh_id: DELETE /Delete/JSON/seohistory/{sh_id} ou avec le tronc {"type": "seohistory", "data": [{"sh_id": …}]}. Jusqu’à la v2.122.10, le nom était ignoré, et la suppression s’effectuait uniquement selon type et base_id; avec ?type=p, toutes les entrées de produit étaient donc supprimées.

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." }
  ]
}

Avant la mise à jour, vérifiez si votre connexion envoie des valeurs contenant des espaces, des sauts de ligne ou des %00 en marge, par exemple à partir d’un fichier importé : ces valeurs sont désormais considérées telles qu’elles apparaissent sans ces caractères.

Suppression réussie

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

Suppression bloquée

{
  "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."
  }
}