更新消息品牌

更正现有消息品牌

企业联系信息或地址变更时，请更新现有品牌。保留其品牌标识符；更正现有企业信息不应通过另建注册来实现。请从获准的源 IP 地址，通过 HTTPS 使用已启用的 API 账户。该品牌必须属于此账户。

首先读取当前记录。本地副本包含企业身份和联系信息，请妥善保密。

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
  --output current-brand.json

保留品牌的当前字段

根据当前记录准备 brand-update.json，仅选择可写的品牌字段。在进行预期更正时，保留企业身份及其他必填值。不要发送完整的 GET 响应：brandId、身份/状态结果、时间戳及其他仅用于响应的字段不应包含在更新中。

更新数据结构要求提供 entityType、displayName、country、email 和 brandRelationship。各实体类型的特定规则仍然适用。对于组织，应根据适用情况保留其法定公司名称、税务标识及签发国家、地址和行业。对于个体经营者，则应保留相关的个人姓名和手机联系字段。请使用当前真实值，不要使用注册示例中的占位值。

品牌更新字段分组
字段	使用方法
displayName, email, phone	易于识别的品牌名称和有效联系信息。最大长度分别为 255、100 和 20 个字符。电话号码应采用以 +国家代码开头的国际格式。
street, city, state, postalCode, country	真实且各项信息相互一致的企业地址。长度上限分别为 255、100、20、10 和 2 个字符。适用时，请使用现行的美国州代码。
entityType, companyName, ein, einIssuingCountry	法定身份。当活动或外部审核处于待处理或进行中状态时，这些变更会受到限制。不要仅为绕过身份限制而删除正在正常使用的活动。
firstName, lastName, mobilePhone, businessContactEmail	适用于该实体类型的身份信息或验证联系人信息。长度上限分别为 100、100、20 和 255 个字符。
brandRelationship, vertical	当前关系和行业代码。关系每三个月最多更改一次。门户的常规编辑表单不提供关系更改功能。
website, altBusinessIdType, altBusinessId, stockSymbol, stockExchange	适用的网站、备用企业身份和上市公司信息。请保留实体验证所需的值。
referenceId, ipAddress	受支持的业务参考信息和来源 IP 元数据。这两项都不能设置账户归属，也不能用作请求的幂等键。

代码请参阅当前的消息代码目录。更新数据结构不支持通过 mock 更改品牌环境。请使用单独的、经过审查的沙箱转生产工作流程，而不要在编辑时更改该标志。

提交已审查的更正

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @brand-update.json \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

为本次预期更新使用同一个键，并原样保留请求正文的字节。更改方法、路径、查询或正文后复用该键会发生冲突；重新格式化 JSON 也会改变指纹。对于正在处理的请求，重复提交可能返回 409，并附带 Retry-After。已完成的请求可能重放其保存的结果，包括错误结果。排查超时并核对结果时，请保留请求详情，不要自动生成新键。

核对已保存的记录和验证状态

更新成功时会返回 HTTP 200 和直接的品牌 JSON 对象，不包含旧版 v3 的 status/response 外层封装。请检查其中的 brandId，然后再次通过 GET 读取同一品牌，比较预期字段。公共更新路由不接受门户的 changes/version 封装，也不提供门户的乐观并发检查。请协调同时进行的编辑；幂等键可防止重复提交，但不能阻止其他编辑者的更改。

当前门户会读取品牌、保留其可写字段、在保存前检查表单版本，并再次读取结果。发现活跃的活动时，门户会锁定核心法定身份字段。即使表单提供了某个字段，注册机构仍可能施加额外限制，包括外部审核限制。

保存更正后的信息不会自动请求新的身份验证，也不保证获得批准。重新验证是一项单独操作，可能产生费用；请在门户查看当前状态，并明确确认任何列出的费用。在当前 API 服务中，常规品牌 PUT 更新不会触发单独的注册扣款。现有活动、消息及其他费用仍单独计收。

解决错误，避免重复注册

请读取 HTTP 状态和 JSON 错误详情。对于 400，请更正具体字段或遵守身份/关系限制。对于 401、403 或 404，请检查凭据、获准的源 IP 和账户归属。对于 429，请遵循 Retry-After。注册机构接受更新后仍可能出现 500 或 502；请保留收到的任何 requestId，并在再次提交之前读取现有记录。

非空但不完整的更新响应可能导致本地快照不完整；正文为空的成功响应可能使快照保留旧字段。不要仅凭成功状态就推断字段已被保留。请重新读取完整品牌记录，并通过支持团队核对和解决任何不一致。本指南不保证注册机构、本地缓存和计费更新以原子方式完成。