Skip to main content

Cancellazione dati Clienti/Fornitori

Permette di cancellare dati di clienti/fornitori precedentemente caricati per una data coppia item/transmitter

API

[DELETE] ​​/api​/v1​/customer-data​/{dataId}

Headers

Gli header richiesti dalla chiamata sono gli header standard di TSDigital.

Il Content-Type deve essere application/json

Path parameters

Il parametro dataId nel path della richiesta deve corrispondere ad un identificativo precedentemente ritornato dall'API di creazione.

Query parameters

I seguenti parametri obbligatori devono essere forniti sotto forma di query parameter:

  • itemId: identificativo dell'item per il quale sono stati caricati i dati
  • transmitterId: identificativo del transmitter che ha caricato i dati

Successo

In caso di successo, l'API risponde con il codice HTTP 204.

La risposta non contiene alcun body.

Errore

In caso di errore, l'API ritorna un body nel formato:

{
  "message": "string"
}

Dove message è un messaggio che indica la ragione dell'errore.

L'API può rispondere con i seguenti codici d'errore:

  • 400: una (o più) parti della richiesta non rispettano lo schema specificato (es: header obbligatorio mancante, parametro obbligatorio del body mancante, ecc.)
  • 401: non è stato fornito un token d'autenticazione, o il token d'autenticazione fornito è scaduto
  • 403: l'utente che ha effettuato la richiesta non ha i permessi necessari per portarla a termine
  • 404: l'id specificato non corrisponde a dati caricati in precedenza
  • 500: si è verificato un errore inaspettato nel completare la richiesta
  • 502: è stato impossibile completare l'upload dei dati verso il servizio che si occupa di conservare i dati