Elencare i caricamenti disponibili per la registrazione

Elencare i riferimenti ai caricamenti disponibili

Utilizza questo endpoint dopo aver completato il caricamento dei documenti di registrazione quando devi trovare riferimenti ancora disponibili per l’aggiunta di allegati. Utilizza un account API MultiTEL abilitato tramite HTTPS, con le credenziali e le restrizioni IP configurate per tale account. L’elenco è limitato al tuo account.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/get_encrypted_files

Non sono necessari un corpo della richiesta né parametri di query. Il gestore elenca i record dei caricamenti creati tramite API il cui indicatore di scadenza non è impostato e la cui data e ora di scadenza sono successive alla data e ora correnti del server. Non espone parametri di paginazione, ricerca o ordinamento. Non si tratta di un elenco di tutte le identità, di tutti i documenti probatori o di tutti i documenti pregressi del tuo account.

Leggere i metadati, non i byte dei documenti

Leggi il risultato HTTP e il campo status.code del contenuto JSON. Una risposta riuscita contiene un array in response; un risultato vuoto è un array vuoto, non un errore di account inesistente. L’esempio utilizza metadati e identificatori fittizi.

{
  "status": {"code": 200, "msg": ""},
  "response": [{
    "id": "0123456789abcdef0123456789abcdef",
    "proof_type": "abcdef0123456789abcdef0123456789",
    "entity_type": "addresses",
    "description": "Example address proof",
    "file_name": "example-document.pdf",
    "date": "2026-10-01 12:00:00"
  }]
}

Campi dei metadati del caricamento
Campo	Significato
`id`	Il riferimento esterno del caricamento. Copialo esattamente nella richiesta di aggiunta dell’allegato pertinente. Non calcolare autonomamente un identificatore e non sostituirlo con l’ID di un’identità, di un indirizzo o di un modello.
`proof_type`	Il riferimento mascherato al tipo registrato, se presente; altrimenti, una stringa vuota. Per i caricamenti di documenti probatori indica il tipo di documento probatorio; i caricamenti di documenti di supporto registrano il riferimento al proprio modello sotto questa stessa chiave. Leggi entity_type per distinguerli. Non è l’ID del caricamento.
`entity_type`	La categoria registrata dell’allegato, ad esempio identities, addresses o supporting_documents. Scegli il flusso corrispondente per l’aggiunta dell’allegato.
`description`	La descrizione memorizzata del caricamento.
`file_name`	Il nome originale del file. Non è un URL per scaricarlo.
`date`	La data e l’ora di creazione registrate, formattate dal server senza indicare lo scostamento del fuso orario.

La risposta non contiene i byte dei documenti, un URL di archiviazione o la data e l’ora di scadenza. Conserva expired_at dalla risposta originale al caricamento. La presenza di un caricamento nell’elenco non ne prolunga la validità, non lo allega a un’identità e non dimostra che un operatore telefonico lo abbia approvato.

Allegare prima che il riferimento scada

Utilizza il flusso appropriato di aggiunta di un documento probatorio come allegato o aggiunta di un documento di supporto come allegato. Il flusso di caricamento attuale assegna ai riferimenti un breve periodo di validità; non rimandare l’aggiunta dell’allegato solo perché un riferimento è comparso in questo elenco. Un riferimento può scadere o diventare indisponibile tra la consultazione dell’elenco e l’aggiunta dell’allegato. Gestisci la risposta alla richiesta di aggiunta dell’allegato senza presumerne l’esito positivo.

Se l’elenco è vuoto inaspettatamente, controlla l’account e verifica se il caricamento è scaduto o è stato creato tramite un altro flusso. Non caricare di nuovo automaticamente gli stessi documenti senza controllare gli esiti del caricamento originale e dell’aggiunta dell’allegato.

Riservatezza

I nomi dei file e le descrizioni possono identificare persone o documenti anche in assenza dei contenuti dei file. Limita l’accesso ed evita di registrare nei log le risposte complete. Per rimuovere un riferimento locale a un caricamento non utilizzato, consulta rimuovere un riferimento a un caricamento; tale operazione non costituisce un servizio completo di cancellazione dei documenti.