Richiesta di eliminazione

L'eliminazione di una connessione è un processo definitivo, che non può essere annullato una volta richiesto. In caso di cancellazione accidentale, sarà necessario rieffettuare il processo di connessione e validazione/certificazione.

La richiesta di eliminazione di una connessione viene inviata con l'apposita API del servizio di scrittura delle connessioni.

DELETE /api/v2/connections/{connectionId}

API che permette di richiedere l'eliminazione di una connessione. È possibile richiedere l'eliminazione di una connessione solamente se si hanno i permessi amministrativi o sul gestore o sulla gestita.

Header

Il servizio richiede gli header standard di TS Digital.

Path Parameters

• connectionId: identificativo univoco della connessione da eliminare

Risposta

HTTP 202

In caso di risposta positiva l'API ritorna un codice HTTP 202

{
  "id": "string"
}

La risposta contiene le seguenti informazioni:

• id: identificativo della connessione eliminata

HTTP 400

Un parametro obbligatorio per la chiamata non è stato specificato, oppure un parametro ha un formato non valido

HTTP 401

Non è stato fornito il token autorizzativo, oppure è scaduto o invalido

HTTP 403

Il token autorizzativo è presente e valido, ma l'utente non ha i permessi necessari per poter rimuovere la connessione

HTTP 404

Non esiste alcuna connessione corrispondente all'ID fornito

HTTP 500

Si è verificato un errore imprevisto nella creazione della richiesta di eliminazione

HTTP 502

Si è verificato un errore imprevisto nella comunicazione con un servizio terzo necessario per completare il processo (es: servizio di autenticazion non disponibile)