Allegare un documento comprovante l'identità o l'indirizzo

Eseguire questo passaggio dopo aver creato l'identità o l'indirizzo e aver caricato i relativi file richiesti tramite create_encrypt_files con il tipo di documento giustificativo selezionato. Utilizzare un identificativo attualmente valido ottenuto da get_proof_types, corrispondente al requisito e alla categoria dell'entità.

Conservare identity_id e address_id restituiti da create_document; l’identificatore UUID del profilo è diverso. La compatibilità dell'aggiunta successiva di documenti comprovanti l'indirizzo ai profili appena creati è ancora in fase di verifica. Se l'indirizzo viene rifiutato, controllare il portale o rivolgersi all'assistenza prima di riprovare.

Creare il documento giustificativo

Utilizzare un account API MultiTEL abilitato e il relativo indirizzo IP autorizzato. Gli esempi utilizzano credenziali HTTP Basic ricavate da variabili d'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 nel 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" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Campi della richiesta
Campo	Significato
`entity_type`	Utilizzare identities o addresses. Scegliere la categoria corrispondente sia all'entità di destinazione sia ai file caricati.
`entity_id`	Identificativo dell'identità o dell'indirizzo appartenente al proprio account. Utilizzare l'identificativo restituito dal flusso di gestione dei documenti; non sostituirlo con un numero di telefono o con l'identificativo di un documento non pertinente.
`proof_type_id`	Identificativo del tipo di documento giustificativo selezionato. Deve essere coerente con il caricamento e con il requisito.
`encrypted_file_ids`	Array JSON non vuoto di identificativi dei file restituiti da create_encrypt_files. I file devono appartenere allo stesso account, non essere scaduti e corrispondere alla categoria dell'entità. Non si tratta di un elenco di percorsi di file locali.

Sono accettati anche dati di modulo con campi ripetuti encrypted_file_ids[]. Preferire un vero array JSON o un array di modulo; non inviare un array codificato in JSON come un normale valore scalare di modulo.

Conservare l'identificativo del documento giustificativo

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

Una risposta positiva conferma la creazione dell'associazione del documento giustificativo. Non conferma l'approvazione dell'identità o dell'indirizzo, la verifica di tutti i requisiti del paese o l'attivazione di un numero di telefono.

Errori e file caricati scaduti

Il codice API 500 viene utilizzato in caso di dati obbligatori mancanti, errori dell'operatore e risposta non valida dell'operatore. Il codice 404 viene utilizzato quando l'entità di destinazione non è associata all'account corrente, il tipo di documento giustificativo non è valido, un file caricato non è reperibile per questo account e questa categoria oppure è scaduto, o non rimangono identificativi di file utilizzabili. Leggere status.msg insieme al codice.

Prima di allegare un file obbligatorio scaduto, caricarlo nuovamente utilizzando la categoria corretta di documento giustificativo. Se uno qualsiasi dei file forniti non è valido, questo gestore si interrompe prima di inviare la richiesta di creazione del documento giustificativo. Non viene esposta alcuna chiave di idempotenza: dopo un timeout, controllare il documento esistente nel portale prima di ripetere l'associazione.