프로필의 수정 가능한 정보 교체
계정이 소유한 기존 등록 프로필을 업데이트하려면 다음 중 하나에서 얻은 로컬 UUID를 사용하세요: create_document 또는 documents. 이 작업은 계정 및 상위 통신사의 데이터를 변경합니다. 저장된 Personal/Business 신원 유형은 변경하지 않으며, 일부 필드만 수정하는 PATCH 작업이 아닙니다.
업데이트 요청
허용된 IP 주소에서 활성화된 MultiTEL API 계정으로 인증하세요. 예제에서는 환경 변수에 저장된 인증 정보와 가상의 데이터를 사용합니다. HTTP 응답뿐 아니라 JSON의 status.code 및 status.msg도 확인하세요.
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 | 필수입니다. 포털은 데이터 URL 접두사 없이 Base64로 인코딩된 PNG 바이트 데이터를 제공합니다. |
| country | 등록 카탈로그에서 주소에 해당하는 국가의 ISO 코드를 지정하세요. 핸들러는 이 코드에 해당하는 국가를 식별하지만, 검토된 주소 업데이트 처리에서는 국가 연결 관계가 변경되지 않습니다. |
| nationality | 기존 Personal 프로필에는 국가 ISO 코드가 필수입니다. |
| company_name, incorporation_country | 기존 Business 프로필에는 필수입니다. 회사명은 최대 64자이며, 설립 국가는 ISO 코드로 지정하세요. |
| 선택 사항이며, 지정할 경우 최대 254자의 유효한 이메일 주소여야 합니다. 저장된 연락처 이메일을 보존하려면 생략하고, 로컬에서 지우려면 빈 값을 보내세요. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | 현재 값으로 설정하려는 값을 보내세요. 생략된 값은 기본적으로 빈 값이 되며, 기존에 저장된 값을 덮어쓸 수 있습니다. |
국가별 등록 규칙에 따라 추가 정보나 특정 형식이 필요할 수 있습니다. 업데이트 정보 전체를 다시 구성할 때 다음 응답에만 의존하지 마세요: get_document. 이 응답은 제한된 정보만 제공하며 국가 선택 항목, email 및 엔티티 ID를 포함하지 않습니다. 사용 권한이 있는 원본 데이터를 보관하거나 포털의 문서 편집기를 사용하세요.
고급 설정: 미리 업로드한 증빙 자료 추가
선택 사항인 identity_encryptfiles 및 address_encryptfiles 배열에는 다음에서 얻은, 계정 소유의 활성 참조를 지정할 수 있습니다: create_encrypt_files. 업로드의 엔티티 범주와 일치시키고 참조가 만료되기 전에 제출하세요. 여러 파일의 증빙 유형이 같더라도 각 파일은 별도의 증빙 요청으로 첨부됩니다. 여러 파일로 구성된 신원 증빙에는 이후 단계의 증빙 자료 첨부 워크플로에서 하나의 배열을 사용하세요.
새로 만든 주소에 대한 이후 주소 증명이 거부되더라도, 프로필 UUID로 대체하거나 신원을 반복해서 다시 만들지 마세요. 작업을 중단하고 포털에서 또는 지원팀을 통해 프로필을 확인하세요. 주소 증명 조회/검색 경로는 여전히 검토 상의 제한 사항입니다.
기존 형식의 성공 및 실패 응답
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}이 엔드포인트의 일반적인 성공 코드는 문자열 success이며, 숫자 200이 아닙니다. 상위 시스템 또는 로컬에서 발생하는 일반적인 실패에는 문자열 error가 사용될 수 있습니다. 숫자 400은 잘못된 필드 또는 증빙 처리 실패, 404는 프로필 부재 또는 잘못된 업로드 파일 참조, 500은 빈 본문 또는 국가를 식별할 수 없는 경우를 나타냅니다. 메시지와 유효성 검사 항목이 있다면 그 내용도 확인하세요. HTTP 200만으로 성공으로 판단하지 마세요.
현재 업데이트의 제한 사항 및 복구
성공이 보고되어도 상위 시스템의 모든 필드가 변경되었다고 보장되지는 않습니다. 검토된 코드는 상위 시스템의 주소 업데이트가 실패한 후에도 로컬 프로필을 저장할 수 있습니다. 상위 시스템의 신원 정보 업데이트에는 email이 포함되지 않습니다. 이 처리 경로에서 주소의 국가 변경 및 주소 설명 동기화가 이루어지는지는 확인되지 않았습니다. 이러한 변경이 필요하다면 상위 시스템의 등록 정보가 업데이트되었다고 가정하지 말고, 포털에서 결과를 확인한 후 지원팀에 문의하세요.
이 업데이트는 전체가 함께 성공하거나 실패하는 하나의 원자적 트랜잭션이 아닙니다. 이후 단계에서 실패가 발생하기 전에 신원 정보 변경과 증빙 자료 첨부가 먼저 이루어질 수 있습니다. 멱등성 키는 제공되지 않습니다. 결과가 불확실한 응답을 받은 경우 재시도하기 전에 프로필과 첨부 파일을 확인하세요. 증빙 자료를 반복해서 제출하면 중복이 생길 수 있습니다. 프로필을 업데이트해도 증빙 자료가 승인되는 것은 아니며, 전화번호가 활성화되지도 않습니다.