Замените податке профила који се могу мењати
Ажурирајте постојећи регистрациони профил који припада налогу помоћу његовог локалног UUID-а из create_document или documents. Ова операција мења податке налога и податке код надређеног оператера. Она не мења сачувани тип идентитета Personal/Business и није PATCH за измену само појединих поља.
Захтев за ажурирање
Аутентификујте се помоћу свог активног MultiTEL API налога са дозвољене IP адресе. Примери користе приступне податке у променљивама окружења и измишљене податке. Прочитајте status.code и status.msg у JSON-у, као и 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": ""
}Пример приказује профил типа Personal; замените податке у њему свим жељеним подацима крајњег корисника и потписом за чију употребу имате овлашћење. Немојте слати привремене потписе или празне вредности као начин да сачувате податке. Подржани су улазни подаци у JSON формату и подаци кодирани као образац.
| Поља | Понашање |
|---|---|
| first_name, last_name, city, postal_code, address | Обавезна; свако може имати највише 64 знака. |
| phone_number | Обавезна нумеричка вредност од најмање осам знакова; користите цифре броја у међународном формату, укључујући позивни број државе. |
| signature | Обавезно. Портал доставља бајтове PNG слике кодиране у Base64, без префикса URL-а за податке. |
| country | Наведите ISO код државе адресе из регистрационог каталога. Обрађивач одређује државу на основу тог кода, иако прегледана операција ажурирања адресе не мења везу са државом. |
| nationality | Обавезан ISO код државе за постојећи профил типа Personal. |
| company_name, incorporation_country | Обавезна за постојећи профил типа Business; назив предузећа може имати највише 64 знака, а држава оснивања се наводи као ISO код. |
| Опциона исправна адреса е-поште са највише 254 знака. Изоставите је да бисте задржали сачувану контакт адресу е-поште; пошаљите празну вредност да бисте је обрисали локално. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | Пошаљите жељене тренутне вредности. Изостављене вредности подразумевано постају празне и могу преписати постојеће сачуване вредности. |
Правила регистрације за одређену државу могу захтевати додатне информације или формате. Немојте састављати потпун захтев за ажурирање само на основу get_document: његов ограничени одговор не садржи поља за избор државе, email и идентификаторе ентитета. Чувајте изворне податке за чију употребу имате овлашћење или користите уређивач докумената на порталу.
Напредно: додајте претходно отпремљене доказе
Опциони низови identity_encryptfiles и address_encryptfiles прихватају активне референце које припадају налогу, добијене из create_encrypt_files. Ускладите категорију ентитета са категоријом отпремљене датотеке и пошаљите захтев пре истека референце. Свака датотека се прилаже у засебном захтеву за доказ, чак и ако више њих има исти тип доказа. За доказ идентитета који се састоји од више датотека користите накнадни поступак за прилагање доказа са једним низом.
Ako je kasniji dokaz adrese odbijen za novokreiranu adresu, nemojte umesto toga navoditi UUID profila niti iznova kreirati identitet. Zaustavite se i proverite profil na portalu ili sa podrškom. Putanja za čitanje/pretragu dokaza adrese ostaje ograničenje pregleda.
Стари формат одговора о успеху и неуспеху
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}Уобичајени код успеха ове крајње тачке је текстуална вредност success, а не број 200. Уобичајени неуспех код надређеног оператера или локално може бити означен текстуалном вредношћу error. Бројчани код 400 обухвата неисправна поља или неуспехе у обради доказа, 404 непостојећи профил или неисправну референцу на отпремљену датотеку, а 500 празно тело захтева или државу која није могла бити одређена. Прочитајте поруку и све ставке провере ваљаности; немојте сматрати сам HTTP 200 потврдом успеха.
Тренутна ограничења ажурирања и опоравак
Пријављени успех не гарантује да је свако поље код надређеног оператера измењено. Прегледани код може сачувати локални профил након неуспелог ажурирања адресе код надређеног оператера. Ажурирање идентитета код надређеног оператера не обухвата email. За овај поступак нису потврђене измене државе адресе ни синхронизација описа адресе. Ако су вам те измене потребне, проверите резултат на порталу и обратите се подршци уместо да претпоставите да је регистрација код надређеног оператера ажурирана.
Ажурирање није једна атомска трансакција: измене идентитета и прилагање доказа могу бити извршени пре каснијег неуспеха. Кључ идемпотентности није доступан. После одговора са неизвесним исходом проверите профил и прилоге пре поновног покушаја; поновљено слање доказа може створити дупликате. Ажурирање профила не значи да су докази одобрени нити активира број.