Scegliere un riferimento di caricamento inutilizzato
Questo endpoint rimuove un record di riferimento a un caricamento appartenente al tuo account. Usalo solo quando hai la certezza che il riferimento non sia più necessario per allegare una prova o allegare un documento giustificativo. Non elimina un’identità o un indirizzo associati alla registrazione.
Ricava l’identificativo esterno del file dalla risposta originale al caricamento o dall’elenco dei caricamenti disponibili. Il gestore cerca prima tale identificativo per il tuo account; se non lo trova, ricorre alla ricerca tramite l’identificativo del fornitore previsto dal sistema precedente. Le nuove integrazioni dovrebbero usare il riferimento esterno esattamente come viene restituito. Non è richiesto alcun corpo della richiesta.
Richiedere la rimozione con un’azione intenzionale
Usa un account API MultiTEL abilitato tramite HTTPS, con le credenziali e le restrizioni IP configurate per tale account. Usa POST affinché la tua applicazione tratti questa operazione come una modifica intenzionale:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefIl gestore attuale non impone restrizioni sul metodo HTTP: anche una richiesta GET può attivare l’eliminazione. Non esporre questo URL come un normale collegamento cliccabile, un’immagine, un segnalibro o una destinazione per anteprime o precaricamento. Richiedi un’azione esplicita di rimozione nella tua applicazione e non riprovare automaticamente.
Interpretare il risultato e i suoi limiti
Leggi sia il risultato HTTP sia il campo status.code nel JSON. La normale risposta in caso di esito positivo è:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Il codice API 404 con Failed, Not found indica che nessuna delle due ricerche ha trovato un riferimento corrispondente per questo account. Ripetere la rimozione può quindi restituire 404. Gli spazi iniziali e finali nel valore del percorso vengono rimossi. In questa fase non viene verificato che il riferimento non sia scaduto o non sia utilizzato da un altro passaggio; verifica quindi il tuo flusso di lavoro prima di rimuoverlo.
Il gestore segnala un esito positivo dopo aver tentato l’eliminazione dal database, senza verificare che l’eliminazione sia riuscita. Considera la risposta come il risultato dichiarato, non come una prova indipendente dell’avvenuta cancellazione. Se un riferimento non scaduto creato tramite API era visibile in get_encrypted_files, tale elenco può aiutare a verificare se è ancora visibile, ma la sua assenza dall’elenco può anche indicare che è scaduto.
La rimozione non equivale alla cancellazione completa dei dati
Il gestore esegue un’operazione di eliminazione sulla tabella dei riferimenti ai caricamenti. Non elimina esplicitamente la riga contenente il contenuto del documento archiviato, il file caricato localmente, la prova allegata, l’identità, il documento giustificativo o la copia detenuta dal fornitore. Il comportamento delle operazioni a cascata del database e della conservazione dei dati non è stato verificato. Non presentare questa operazione agli utenti come un’eliminazione di tutte le copie del loro documento d’identità o come l’adempimento di una richiesta di cancellazione completa.
Una volta rimosso il riferimento locale, i successivi passaggi di aggiunta di allegati che ne hanno bisogno potrebbero non riuscire. Conserva i risultati delle operazioni di aggiunta di allegati già completate e usa il flusso di gestione dell’identità o delle prove pertinente quando modifichi le informazioni di registrazione già inviate.