Endpoint Eliminazione Prodotto

Rimuovi permanentemente un prodotto dal tuo inventario

DELETE

L'endpoint di eliminazione consente di rimuovere permanentemente un prodotto e tutti i suoi dati associati dal tuo inventario. È possibile identificare il prodotto tramite codice EAN, ASIN, GTIN, MINSAN o SKU.

Questa azione è irreversibile e cancellerà il prodotto da tutti i paesi nel tuo inventario.

URL dell'Endpoint

DELETE https://api.commerceclarity.io/api/v1/products/delete

Corpo della Richiesta

Parametro	Tipo	Obbligatorio	Descrizione
`code`	string	Obbligatorio	Identificatore del prodotto. Può essere un codice EAN, ASIN, GTIN, MINSAN o SKU

Stati di Risposta

Codice	Status	Descrizione
200	success	Prodotto eliminato con successo dall'inventario
404	error	Prodotto non trovato con l'identificatore fornito
500	error	Errore interno del server durante l'eliminazione

Esempi di Risposta

Risposta di Successo

{
  "status": "success"
}

Risposta di Errore - Validazione

{
  "message": "The product with the provided code could not be found."
}

Risposta Errore Server

{
  "message": "An internal server error occurred during deletion."
}

Esempi di Codice

Esempio PHP (Utilizzo del Client HTTP Guzzle)

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

$client = new Client([
    'base_uri' => 'https://api.commerceclarity.io',
    'timeout'  => 10.0,
    'headers' => [
        'Authorization' => 'Bearer IL_TUO_TOKEN_API',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ]
]);

$productCode = '8004120057724'; // Codice prodotto da eliminare

try {
    $response = $client->delete('/api/v1/products/delete', [
        'json' => [
            'code' => $productCode
        ]
    ]);
    
    $result = json_decode($response->getBody()->getContents(), true);
    
    if ($result['status'] === 'success') {
        echo "Prodotto eliminato con successo: " . $productCode . "\n";
    } else {
        echo "Errore nell'eliminazione del prodotto: " . ($result['message'] ?? 'Errore sconosciuto') . "\n";
    }
    
} catch (RequestException $e) {
    echo "Errore: " . $e->getMessage() . "\n";
    
    if ($e->hasResponse()) {
        $errorResponse = json_decode($e->getResponse()->getBody()->getContents(), true);
        echo "Codice errore: " . $e->getResponse()->getStatusCode() . "\n";
        echo "Messaggio: " . ($errorResponse['message'] ?? 'nessun messaggio') . "\n";
    }
}
?>

Esempio JavaScript (Fetch API)

const productCode = '8004120057724'; // Codice prodotto da eliminare
const apiUrl = 'https://api.commerceclarity.io/api/v1/products/delete';
const token = 'IL_TUO_TOKEN_API';

// Effettua la richiesta di eliminazione API
fetch(apiUrl, {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    code: productCode
  })
})
.then(response => {
  if (!response.ok) {
    return response.json().then(errorData => {
      throw new Error(errorData.message || `Status: ${response.status}`);
    });
  }
  return response.json();
})
.then(data => {
  if (data.status === 'success') {
    console.log(`Prodotto eliminato con successo: ${productCode}`);
  } else {
    console.log(`Errore nell'eliminazione del prodotto: ${data.message || 'Errore sconosciuto'}`);
  }
})
.catch(error => {
  console.error('Errore nell'eliminazione del prodotto:', error.message);
});

Esempio Python (Requests)

import requests
import json

# Configurazione API
product_code = '8004120057724'  # Codice prodotto da eliminare
api_url = 'https://api.commerceclarity.io/api/v1/products/delete'
token = 'IL_TUO_TOKEN_API'

headers = {
    'Authorization': f'Bearer {token}',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
}

data = {
    'code': product_code
}

try:
    # Effettua la richiesta di eliminazione
    response = requests.delete(api_url, headers=headers, json=data)
    
    # Solleva eccezione per errori HTTP
    response.raise_for_status()
    
    # Estrai i dati dalla risposta
    result = response.json()
    
    if result['status'] == 'success':
        print(f"Prodotto eliminato con successo: {product_code}")
    else:
        print(f"Errore nell'eliminazione del prodotto: {result.get('message', 'Errore sconosciuto')}")
        
except requests.exceptions.HTTPError as err:
    print(f"Errore HTTP: {err}")
    if response.text:
        try:
            error_data = response.json()
            print(f"Messaggio di errore: {error_data.get('message', 'nessun messaggio')}")
        except json.JSONDecodeError:
            print(f"Testo di risposta: {response.text}")
        
except requests.exceptions.RequestException as err:
    print(f"Errore durante la richiesta: {err}")

Esempio cURL

curl -X DELETE "https://api.commerceclarity.io/api/v1/products/delete" \
  -H "Authorization: Bearer IL_TUO_TOKEN_API" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "8004120057724"
  }'

Risorse Correlate

Dettagli Prodotto

Verifica lo stato attuale di un prodotto specifico nel tuo inventario.

Vai a Dettagli Prodotto

Creazione Prodotti

Impara come creare e analizzare nuovi prodotti.

Vai alla Creazione Prodotti

Playground API

Autenticazione Richiesta