Sostituire i dati modificabili di un profilo
Aggiorna un profilo di registrazione esistente appartenente all’account usando il relativo UUID locale ottenuto da create_document o documents. Questa operazione modifica i dati dell’account e quelli presso l’operatore a monte. Non modifica il tipo di identità Personal/Business memorizzato e non è una PATCH di singoli campi.
Richiesta di aggiornamento
Autenticati con il tuo account API MultiTEL abilitato da un indirizzo IP consentito. Gli esempi usano credenziali in variabili d’ambiente e dati fittizi. Leggi i campi JSON status.code e status.msg oltre alla risposta HTTP.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--header 'Content-Type: application/json' \
--data @registration-profile-update.json \
"https://api.multitel.net/v3/update_document/$DOCUMENT_UUID"{
"first_name": "Example",
"last_name": "Person",
"phone_number": "12025550123",
"email": "end-user@example.com",
"city": "Example City",
"postal_code": "00000",
"address": "1 Example Street",
"country": "US",
"nationality": "US",
"signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE",
"id_number": "",
"personal_tax_id": "",
"birth_date": "",
"description": "Example profile",
"company_name": "",
"company_reg_number": "",
"incorporation_country": "",
"vat_id": "",
"address_description": ""
}L’esempio illustra un profilo Personal; sostituiscilo con tutti i dati desiderati dell’utente finale e la sua firma autorizzata. Non inviare firme segnaposto o valori vuoti per conservare i dati. Sono supportati dati in ingresso in formato JSON e con codifica da modulo.
| Campi | Comportamento |
|---|---|
| first_name, last_name, city, postal_code, address | Obbligatori; ciascuno con un massimo di 64 caratteri. |
| phone_number | Valore numerico obbligatorio di almeno otto caratteri; usa le cifre del numero in formato internazionale, incluso il prefisso del paese. |
| signature | Obbligatoria. Il portale fornisce i byte PNG codificati in Base64 senza il prefisso dell’URL di dati. |
| country | Fornisci un codice ISO del paese dell’indirizzo presente nel catalogo di registrazione. Il gestore lo risolve, anche se l’aggiornamento dell’indirizzo esaminato non modifica l’associazione al paese. |
| nationality | Codice ISO del paese obbligatorio per un profilo Personal esistente. |
| company_name, incorporation_country | Obbligatori per un profilo Business esistente; la ragione sociale può contenere al massimo 64 caratteri e il paese di costituzione deve essere un codice ISO. |
| Indirizzo email valido facoltativo, fino a 254 caratteri. Omettilo per conservare l’indirizzo email di contatto memorizzato; invia un valore vuoto per cancellarlo localmente. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | Invia i valori correnti desiderati. I valori omessi vengono impostati come vuoti per impostazione predefinita e possono sovrascrivere i valori già memorizzati. |
Le regole di registrazione specifiche del paese possono richiedere informazioni o formati aggiuntivi. Non ricostruire un aggiornamento completo basandoti su get_document soltanto: la sua risposta limitata omette i selettori del paese, email e gli identificativi delle entità. Conserva i dati di origine che sei autorizzato a utilizzare oppure usa l’editor dei documenti del portale.
Avanzate: aggiungere documenti giustificativi già caricati
Gli array facoltativi identity_encryptfiles e address_encryptfiles accettano riferimenti attivi appartenenti all’account ottenuti da create_encrypt_files. Usa la stessa categoria di entità del caricamento e invia la richiesta prima della scadenza del riferimento. Ogni file viene allegato in una richiesta separata di documento giustificativo, anche se più file condividono lo stesso tipo di documento. Per una prova d’identità composta da più file, usa il successivo flusso di inserimento di allegati giustificativi con un unico array.
Se una successiva prova di indirizzo viene rifiutata per un indirizzo appena creato, non sostituire l'UUID del profilo né ricreare ripetutamente l'identità. Fermarsi e verificare il profilo nel portale o con l'assistenza. Il percorso di rilettura/ricerca della prova di indirizzo resta una limitazione della revisione.
Risposte di esito positivo e di errore nel formato preesistente
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}Il codice di esito positivo normalmente restituito da questo endpoint è la stringa success, anziché il valore numerico 200. Un normale errore a monte o locale può usare la stringa error. Il codice numerico 400 indica campi non validi o errori relativi ai documenti giustificativi, 404 un profilo mancante o un riferimento non valido a un file caricato e 500 un corpo vuoto o un paese non risolto. Leggi il messaggio e le eventuali voci di convalida; non considerare il solo HTTP 200 come un esito positivo.
Limiti attuali dell’aggiornamento e ripristino
Un esito positivo segnalato non garantisce che ogni campo a monte sia stato modificato. Il codice esaminato può salvare il profilo locale dopo il fallimento di un aggiornamento dell’indirizzo a monte. L’aggiornamento dell’identità a monte non include email. Questo percorso non garantisce né le modifiche al paese dell’indirizzo né la sincronizzazione della descrizione dell’indirizzo. Se hai bisogno di queste modifiche, verifica il risultato nel portale e contatta l’assistenza, senza presumere che la registrazione a monte sia stata aggiornata.
L’aggiornamento non è un’unica transazione atomica: le modifiche all’identità e l’inserimento di allegati giustificativi possono precedere un errore successivo. Non viene esposta alcuna chiave di idempotenza. Dopo una risposta incerta, controlla il profilo e gli allegati prima di riprovare; l’invio ripetuto di documenti giustificativi può creare duplicati. L’aggiornamento di un profilo non implica l’approvazione dei documenti giustificativi né attiva un numero.