Rimuovere consapevolmente un profilo di registrazione
Questa operazione preesistente tenta di eliminare l'identità e l'indirizzo presso l'operatore appartenenti all'account, quindi contrassegna il profilo locale come eliminato. Individuare l'UUID corretto del profilo locale tramite documents e controllare il profilo nel portale prima di richiamare l'operazione. Non si tratta di una rimozione dei soli documenti comprovanti né di un'operazione di annullamento.
Richiesta distruttiva preesistente
Autenticarsi con il proprio account API MultiTEL abilitato da un indirizzo IP consentito. Gli esempi utilizzano credenziali nelle variabili d'ambiente e dati fittizi. Leggere i campi JSON status.code e status.msg, oltre alla risposta HTTP.
Il portale attuale richiama questa operazione tramite GET. Nonostante il metodo HTTP, l'operazione modifica i dati. Non utilizzare mai l'URL in un collegamento, un'immagine, un controllo di disponibilità del servizio, un precaricamento del browser, un crawler o un nuovo tentativo automatico. Nella propria integrazione, richiedere una decisione esplicita dell'utente di procedere all'eliminazione.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"DOCUMENT_UUID è l'identificativo del profilo locale restituito come uuid durante la creazione o come id durante la successiva lettura del profilo. Non è l'ID dell'identità, l'ID dell'indirizzo né un numero di telefono. Non viene utilizzato alcun corpo della richiesta.
Risultato segnalato
{
"status": {
"code": 200,
"msg": "Success"
},
"response": []
}Il codice API 404 con il messaggio Failed, Not found indica che l'UUID del profilo non è stato trovato per questo account. Un codice 200 segnalato indica che il gestore ha raggiunto la risposta di completamento; non dimostra che l'operatore abbia eliminato l'identità e l'indirizzo o che l'aggiornamento del database locale sia riuscito.
Verificare la rimozione e la sua portata
Il gestore attuale non verifica gli esiti dell'eliminazione presso l'operatore né dell'aggiornamento locale. Dopo una segnalazione di esito positivo, verificare che il profilo sia assente dai risultati attivi di documents e che risulti non trovato tramite get_document. Questi controlli accertano soltanto la visibilità locale. Non dimostrano l'eliminazione presso un operatore a monte.
Questo endpoint non è un'API generale per la cancellazione dei dati personali. Non accerta l'eliminazione di file caricati, documenti comprovanti, documenti di supporto, registri, copie di backup o altri dati conservati. Per ottenere conferma della rimozione a monte o presentare una richiesta di cancellazione dei dati, contattare l'assistenza. Non richiamare ripetutamente l'operazione di eliminazione al posto di verificare un esito parziale.