Zamijenite podatke profila koji se mogu uređivati
Ažurirajte postojeći registracijski profil koji pripada računu koristeći njegov lokalni UUID iz create_document ili documents. Ova radnja mijenja podatke na računu i kod nadređenog operatera. Ne mijenja pohranjenu vrstu identiteta Personal/Business i nije PATCH za djelomično ažuriranje polja.
Zahtjev za ažuriranje
Autentificirajte se svojim omogućenim računom za MultiTEL API s dopuštene IP adrese. Primjeri koriste vjerodajnice u varijablama okruženja i izmišljene podatke. Pročitajte status.code i status.msg u JSON-u te HTTP odgovor.
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": ""
}Primjer prikazuje profil vrste Personal; zamijenite ga svim predviđenim podacima krajnjeg korisnika i njegovim ovlaštenim potpisom. Nemojte slati zamjenske potpise ni prazne vrijednosti radi očuvanja podataka. Podržani su JSON i unos kodiran kao obrazac.
| Polja | Ponašanje |
|---|---|
| first_name, last_name, city, postal_code, address | Obavezna; svako smije sadržavati najviše 64 znaka. |
| phone_number | Obavezna brojčana vrijednost s najmanje osam znakova; koristite znamenke u međunarodnom formatu, uključujući pozivni broj države. |
| signature | Obavezno. Portal dostavlja bajtove PNG-a kodirane u Base64 bez prefiksa podatkovnog URL-a. |
| country | Navedite ISO kod države adrese iz registracijskog kataloga. Obrada zahtjeva pronalazi odgovarajuću državu prema kodu, iako pregledano ažuriranje adrese ne mijenja povezanost s državom. |
| nationality | Obavezan ISO kod države za postojeći profil vrste Personal. |
| company_name, incorporation_country | Obavezna za postojeći profil vrste Business; naziv tvrtke smije sadržavati najviše 64 znaka, a država osnivanja navodi se ISO kodom. |
| Neobavezna valjana adresa e-pošte s najviše 254 znaka. Izostavite je kako biste sačuvali pohranjenu kontaktnu adresu e-pošte; pošaljite praznu vrijednost kako biste je izbrisali lokalno. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | Pošaljite predviđene trenutačne vrijednosti. Izostavljene vrijednosti prema zadanim postavkama postaju prazne i mogu prebrisati postojeće pohranjene vrijednosti. |
Registracijska pravila pojedine države mogu zahtijevati dodatne podatke ili određene formate. Nemojte sastavljati potpuno ažuriranje samo na temelju odgovora iz get_document: taj ograničeni odgovor izostavlja odabire država, email i identifikatore entiteta. Sačuvajte izvorne podatke koje ste ovlašteni koristiti ili upotrijebite uređivač dokumenata na portalu.
Napredno: dodajte prethodno učitane dokaze
Neobavezni nizovi identity_encryptfiles i address_encryptfiles prihvaćaju aktivne reference koje pripadaju računu, dobivene iz create_encrypt_files. Uskladite kategoriju entiteta s kategorijom pri učitavanju i pošaljite zahtjev prije isteka reference. Svaka se datoteka prilaže u zasebnom zahtjevu za dokaz, čak i ako više datoteka pripada istoj vrsti dokaza. Za dokaz identiteta koji sadrži više datoteka upotrijebite naknadni postupak za prilaganje dokaza s jednim nizom.
Ako je kasniji dokaz adrese odbijen za novostvorenu adresu, nemojte umjesto toga koristiti UUID profila niti opetovano ponovno stvarati identitet. Zaustavite se i provjerite profil na portalu ili s podrškom. Put za očitavanje/pretraživanje dokaza adrese i dalje je ograničenje pregleda.
Naslijeđeni odgovori o uspjehu i neuspjehu
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}Uobičajeni kod uspjeha ove krajnje točke jest tekstualni niz success, umjesto brojčane vrijednosti 200. Uobičajeni neuspjeh kod nadređenog operatera ili lokalno može koristiti tekstualni niz error. Brojčani kod 400 obuhvaća nevaljana polja ili pogreške povezane s dokazima, 404 nepostojeći profil ili nevaljanu referencu na učitanu datoteku, a 500 prazno tijelo zahtjeva ili državu koju nije moguće odrediti. Pročitajte poruku i sve zapise provjere valjanosti; nemojte sam HTTP 200 smatrati uspjehom.
Trenutačna ograničenja ažuriranja i oporavak
Prijavljeni uspjeh ne jamči da su promijenjena sva polja kod nadređenog operatera. Pregledani kod može spremiti lokalni profil nakon neuspjelog ažuriranja adrese kod operatera. Ažuriranje identiteta kod operatera ne uključuje email. Nije utvrđeno da ovaj postupak mijenja državu adrese ili sinkronizira opis adrese. Ako su vam potrebne te promjene, pregledajte rezultat na portalu i obratite se podršci umjesto da pretpostavite da je registracija kod operatera ažurirana.
Ažuriranje nije jedna atomska transakcija: promjene identiteta i prilaganje dokaza mogu prethoditi kasnijem neuspjehu. Ključ idempotentnosti nije dostupan. Nakon neizvjesnog odgovora pregledajte profil i privitke prije ponovnog pokušaja; ponovljeno slanje dokaza može stvoriti duplikate. Ažuriranjem profila ne odobravaju se dokazi niti se aktivira broj.