更新注册资料

替换资料中的可编辑详情

更新账户名下的现有注册资料时，请使用其本地 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	必填。门户提供经过 Base64 编码的 PNG 字节，不含数据 URL 前缀。
country	请提供注册目录中地址所在国家的 ISO 代码。处理程序会根据该代码解析出对应国家，但已审查的地址更新操作不会更改国家关联。
nationality	对于现有的 Personal 类型资料，国家 ISO 代码为必填项。
company_name, incorporation_country	对于现有的 Business 类型资料，这些字段为必填项；公司名称最多 64 个字符，公司注册国家须使用 ISO 代码。
email	可选，须为有效的电子邮件地址，最多 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。尚未确认此流程能更改地址所在国家或同步地址描述。如果您需要这些更改，请在门户中检查结果并联系支持人员，不要假定上游注册信息已经更新。

此次更新不是单一的原子事务：身份更改和证明材料附加可能已经完成，随后才发生失败。接口未提供幂等键。收到结果不明确的响应后，请先检查资料和附件，再决定是否重试；重复提交证明材料可能产生重复项。更新资料并不意味着证明材料已获批准，也不会激活号码。