Înlocuirea datelor editabile ale unui profil
Actualizați un profil de înregistrare existent care aparține contului, folosind UUID-ul său local din create_document sau documents. Această operațiune modifică datele contului și datele din sistemul operatorului din amonte. Nu modifică tipul de identitate stocat Personal/Business și nu reprezintă o operațiune PATCH pentru actualizarea parțială a câmpurilor.
Cererea de actualizare
Autentificați-vă cu contul API MultiTEL activat, de la o adresă IP permisă. Exemplele folosesc date de autentificare din variabile de mediu și date fictive. Citiți câmpurile JSON status.code și status.msg, precum și răspunsul 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": ""
}Exemplul prezintă un profil Personal; înlocuiți-l cu toate datele dorite ale utilizatorului final și cu semnătura autorizată a acestuia. Nu trimiteți semnături provizorii sau valori goale ca modalitate de păstrare a datelor. Sunt acceptate date de intrare în format JSON și codificate ca formular.
| Câmpuri | Comportament |
|---|---|
| first_name, last_name, city, postal_code, address | Obligatorii; fiecare poate avea cel mult 64 de caractere. |
| phone_number | Valoare numerică obligatorie de cel puțin opt caractere; folosiți cifre în format internațional, inclusiv codul de țară. |
| signature | Obligatoriu. Portalul furnizează octeții PNG codificați Base64, fără prefixul URL de date. |
| country | Furnizați un cod ISO pentru țara adresei din catalogul de înregistrare. Componenta de procesare identifică țara corespunzătoare, deși actualizarea adresei din codul revizuit nu modifică asocierea cu țara. |
| nationality | Cod ISO de țară obligatoriu pentru un profil Personal existent. |
| company_name, incorporation_country | Obligatorii pentru un profil Business existent; numele companiei poate avea cel mult 64 de caractere, iar țara de înființare trebuie indicată printr-un cod ISO. |
| Adresă de e-mail validă, opțională, de cel mult 254 de caractere. Omiteți câmpul pentru a păstra adresa de e-mail de contact stocată; trimiteți o valoare goală pentru a o șterge local. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | Trimiteți valorile curente dorite. Valorile omise sunt implicit goale și pot suprascrie valorile existente stocate. |
Regulile de înregistrare specifice fiecărei țări pot impune informații sau formate suplimentare. Nu reconstruiți o actualizare completă folosind get_document ca unică sursă: răspunsul său limitat omite selectoarele de țară, email și identificatorii entităților. Păstrați datele sursă autorizate sau folosiți editorul de documente al portalului.
Avansat: adăugarea documentelor justificative încărcate anterior
Listele opționale identity_encryptfiles și address_encryptfiles acceptă referințe active care aparțin contului, obținute din create_encrypt_files. Respectați categoria de entitate a fișierului încărcat și trimiteți cererea înainte de expirarea referinței. Fiecare fișier este anexat printr-o cerere separată de document justificativ, chiar dacă mai multe fișiere au același tip de document justificativ. Pentru o dovadă de identitate cu mai multe fișiere, folosiți ulterior fluxul de anexare a documentelor justificative cu o singură listă.
Dacă o dovadă de adresă ulterioară este respinsă pentru o adresă nou creată, nu înlocuiți cu UUID-ul profilului și nu recreați identitatea în mod repetat. Opriți-vă și verificați profilul în portal sau împreună cu asistența. Calea de citire/căutare a dovezilor de adresă rămâne o limitare a examinării.
Răspunsuri de succes și de eroare în formatul vechi
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}Codul obișnuit de succes al acestui punct final este șirul success, în locul valorii numerice 200. O eroare obișnuită în sistemul din amonte sau în sistemul local poate folosi șirul error. Codul numeric 400 indică câmpuri nevalide sau erori legate de documentele justificative, 404 indică un profil inexistent sau o referință nevalidă la un fișier încărcat, iar 500 indică un corp de cerere gol sau o țară care nu a putut fi identificată. Citiți mesajul și toate detaliile de validare; nu considerați simpla primire a codului HTTP 200 drept succes.
Limitările actuale ale actualizării și recuperarea după erori
Un succes raportat nu garantează că toate câmpurile din sistemul din amonte au fost modificate. Codul revizuit poate salva profilul local după ce actualizarea adresei în sistemul din amonte eșuează. Actualizarea identității în sistemul din amonte nu include email. Această cale de procesare nu confirmă modificarea țării adresei sau sincronizarea descrierii adresei. Dacă aveți nevoie de aceste modificări, verificați rezultatul în portal și contactați asistența, în loc să presupuneți că înregistrarea din sistemul din amonte a fost actualizată.
Actualizarea nu este o singură tranzacție atomică: modificările identității și anexarea documentelor justificative pot avea loc înaintea unei erori ulterioare. Nu este disponibilă nicio cheie de idempotență. După un răspuns incert, verificați profilul și anexele înainte de a reîncerca; trimiterea repetată a documentelor justificative poate crea duplicate. Actualizarea unui profil nu înseamnă aprobarea documentelor justificative și nu activează un număr.