Erstat en profils redigerbare oplysninger
Opdater en eksisterende registreringsprofil, der tilhører kontoen, ved hjælp af dens lokale UUID fra create_document eller documents. Denne handling ændrer data på kontoen og hos den bagvedliggende operatør. Den ændrer ikke den gemte identitetstype Personal/Business og er ikke en PATCH, der kun opdaterer enkelte felter.
Opdateringsanmodning
Autentificer dig med din aktiverede MultiTEL API-konto fra en tilladt IP-adresse. Eksemplerne bruger legitimationsoplysninger i miljøvariabler og fiktive data. Læs både status.code og status.msg i JSON samt HTTP-svaret.
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": ""
}Eksemplet viser en profil af typen Personal; erstat det med alle slutbrugerens tilsigtede oplysninger og autoriserede underskrift. Indsend ikke pladsholderunderskrifter eller tomme værdier som en måde at bevare data på. Input i JSON og formularenkodet input understøttes.
| Felter | Virkemåde |
|---|---|
| first_name, last_name, city, postal_code, address | Påkrævede; højst 64 tegn i hvert felt. |
| phone_number | Påkrævet numerisk værdi på mindst otte tegn; brug cifre i internationalt format inklusive landekode. |
| signature | Påkrævet. Portalen leverer Base64-kodede PNG-bytes uden data-URL-præfikset. |
| country | Angiv en ISO-kode fra registreringskataloget for adressens land. Anmodningshåndteringen slår koden op, selvom den gennemgåede adresseopdatering ikke ændrer tilknytningen til landet. |
| nationality | Påkrævet ISO-landekode for en eksisterende profil af typen Personal. |
| company_name, incorporation_country | Påkrævede for en eksisterende profil af typen Business; virksomhedsnavnet må højst være på 64 tegn, og stiftelseslandet skal angives som en ISO-kode. |
| Valgfri, gyldig e-mailadresse på op til 254 tegn. Udelad feltet for at bevare den gemte kontaktadresse; send en tom værdi for at rydde den lokalt. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | Send de tilsigtede aktuelle værdier. Udeladte værdier bliver som standard tomme og kan overskrive eksisterende gemte værdier. |
De landespecifikke registreringsregler kan kræve yderligere oplysninger eller bestemte formater. Sammensæt ikke en komplet opdatering ud fra get_document alene: det begrænsede svar udelader landevalg, email og entitets-id'er. Bevar de kildedata, du har tilladelse til at bruge, eller brug portalens dokumenteditor.
Avanceret: tilføj allerede uploadet dokumentation
De valgfrie arrays identity_encryptfiles og address_encryptfiles accepterer aktive referencer, der tilhører kontoen, fra create_encrypt_files. Brug samme entitetskategori som ved uploaden, og indsend, før referencen udløber. Hver fil vedhæftes i en separat dokumentationsanmodning, selv hvis flere filer har samme dokumentationstype. Til identitetsdokumentation med flere filer skal du bruge den efterfølgende arbejdsgang til vedhæftning af dokumentation med ét array.
Hvis et senere adressebevis afvises for en nyoprettet adresse, må du ikke bruge profilens UUID i stedet eller genoprette identiteten gentagne gange. Stop, og kontrollér profilen i portalen eller hos support. Stien til udlæsning/opslag af adressebeviser er fortsat en begrænsning i gennemgangen.
Ældre svarformater ved succes og fejl
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}Dette endpoints normale succeskode er strengen success, frem for talværdien 200. En almindelig fejl hos den bagvedliggende operatør eller lokalt kan bruge strengen error. Talkoden 400 dækker ugyldige felter eller fejl ved dokumentation, 404 en manglende profil eller en ugyldig reference til en uploadet fil, og 500 en tom anmodningstekst eller et land, der ikke kunne identificeres. Læs meddelelsen og eventuelle valideringsposter; betragt ikke HTTP 200 alene som en succes.
Aktuelle begrænsninger ved opdatering og gendannelse
En rapporteret succes garanterer ikke, at alle felter hos den bagvedliggende operatør blev ændret. Den gennemgåede kode kan gemme den lokale profil, efter at en adresseopdatering hos operatøren er mislykkedes. Identitetsopdateringen hos operatøren omfatter ikke email. Det er ikke fastslået, at denne fremgangsmåde ændrer adressens land eller synkroniserer adressebeskrivelsen. Hvis du har brug for disse ændringer, skal du gennemgå resultatet i portalen og kontakte support i stedet for at antage, at registreringen hos operatøren blev opdateret.
Opdateringen er ikke én atomisk transaktion: identitetsændringer og vedhæftning af dokumentation kan ske før en senere fejl. Der stilles ingen idempotensnøgle til rådighed. Efter et usikkert svar skal du kontrollere profilen og bilagene, før du prøver igen; gentagen indsendelse af dokumentation kan skabe dubletter. Opdatering af en profil medfører ikke godkendelse af dokumentation eller aktivering af et nummer.