Caricare prima di allegare
Caricare i file per una sola categoria di prova o di documento integrativo, quindi allegare gli ID dei file restituiti tramite create_proof oppure create_supporting_document. Il solo caricamento non crea un'identità, un indirizzo, una prova né una registrazione del numero completata. Iniziare dai requisiti aggiornati e dagli ID dei cataloghi.
Specificare esattamente un selettore: proof_type_id per una prova di identità o indirizzo, oppure supporting_template_id per un documento integrativo. Non inviarli entrambi. Utilizzare gli ID restituiti dal catalogo MultiTEL pertinente; considerarli identificatori opachi.
Richiesta di caricamento
Utilizzare un account API MultiTEL abilitato e l'indirizzo IP autorizzato per tale account. Gli esempi utilizzano credenziali HTTP Basic ricavate da variabili di ambiente; seguire le convenzioni di autenticazione previste per il proprio tipo di account. Inviare le richieste tramite HTTPS. Controllare sia la risposta HTTP sia il campo JSON status.code; gli errori applicativi possono essere restituiti con HTTP 200. Gli esempi seguenti sono fittizi.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--form-string "proof_type_id=$PROOF_TYPE_ID" \
--form-string 'description=Identity proof' \
--form 'files[0]=@./identity-proof.pdf' \
https://api.multitel.net/v3/create_encrypt_files| Campo | Significato |
|---|---|
files[0] … files[4] | Da uno a cinque file caricati. Utilizzare dati di modulo multipart e lasciare che curl generi il delimitatore di Content-Type. Questi campi contengono i byte dei file, non URL né dati Base64 in JSON. |
proof_type_id | Obbligatorio per caricare una prova; utilizzare un ID del tipo di prova restituito. Omettere supporting_template_id. |
supporting_template_id | Obbligatorio al posto di proof_type_id per i file integrativi; utilizzare un ID del modello restituito. |
description | Descrizione facoltativa fornita dal chiamante, di massimo 100 caratteri. Per il caricamento di documenti integrativi, se la descrizione viene omessa, è possibile utilizzare il nome del modello. |
Limiti dei file
Questo gestore accetta al massimo cinque file e un totale di 20,000,000 byte. Si tratta di un limite in byte decimali, non di 20 MiB. L'infrastruttura o la convalida MIME possono imporre ulteriori limiti.
Le estensioni consentite sono pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf e csv. Un'estensione consentita non dimostra che il file soddisfi il requisito di registrazione selezionato. In particolare, tif non è tra le estensioni consentite.
Controllare ogni file restituito
{
"status": {
"code": 200,
"msg": "Encrypt file has been created successfully"
},
"response": {
"entity_type": "identities",
"document_category": "proof",
"proof_type": "11111111111111111111111111111111",
"ids": [
{
"id": "22222222222222222222222222222222",
"name": "identity-proof.pdf",
"expired_at": "2026-10-23 16:20:00"
}
]
}
}Conservare ogni response.ids[].id per la richiesta con cui allegare i file. name identifica il nome del file di origine restituito. Utilizzare nomi di file distinti e confrontare i file restituiti con l'insieme previsto: il codice 200 può indicare un lotto elaborato solo parzialmente con successo. Non allegare un insieme in cui mancano file obbligatori.
entity_type vale identities oppure addresses per una prova e supporting_documents per il caricamento di documenti integrativi. document_category vale proof oppure supporting. Il campo della risposta denominato genericamente proof_type contiene anche un riferimento al modello per il caricamento di documenti integrativi; conservare il valore originale di supporting_template_id per allegare i file.
Allegare tempestivamente
Il servizio imposta una scadenza a circa 20 minuti dal salvataggio locale del caricamento. Quando si allega il file, viene verificato che appartenga allo stesso account, che non sia contrassegnato come scaduto, che la scadenza non sia ancora trascorsa e che abbia la categoria di entità corretta. expired_at non include uno scostamento di fuso orario in questa risposta; non presumere che sia in UTC. Allegare tempestivamente, evitando di pianificare l'operazione a ridosso della scadenza.
La scadenza del riferimento al caricamento non garantisce che tutte le copie archiviate dei documenti vengano eliminate in quel momento. Il servizio crittografa i file per il caricamento presso l'operatore e conserva i byte originali per il flusso di gestione dei documenti; non considerarlo una crittografia eseguita esclusivamente sul client né un servizio senza conservazione dei dati. Non inserire ID, nomi di file e risposte nei log pubblici.
Errori e nuovi tentativi
Il gestore attuale utilizza il codice API 404 quando non vengono forniti file di documenti e il codice 500 per problemi di convalida della descrizione, selettori mancanti o in conflitto, ID di tipi di prova o modelli non validi, superamento del limite sul numero di file o sulle dimensioni complessive, problemi di archiviazione o caricamenti non riusciti. Leggere status.msg; i dati di input non validi non sono sempre rappresentati dal codice 400.
Qui non è disponibile alcuna chiave di idempotenza per il client. Se la risposta va persa, controllare il flusso di gestione dei documenti prima di ripetere un caricamento; un'altra richiesta può creare nuovi riferimenti ai file. Questi esempi non sono stati eseguiti su documenti di identità dei clienti.