停用消息品牌

选择停用流程

当企业不再需要该注册时，可停用消息品牌。这会停止使用现有注册，但不会注册替代品牌、释放租用的电话号码或更正企业身份信息。如需更正，请使用“更新消息品牌”。

公开的品牌 DELETE 调用与门户的“删除品牌”操作范围不同。公开调用会从注册机构删除一个品牌。门户则会先协调号码解绑和营销活动停用，再尝试删除品牌。

在门户中审查影响

打开消息注册页面，找到正确的品牌并选择“删除品牌”。查看关联营销活动数和已分配号码数。准确输入品牌标识符以启用最终操作。只有账户具备注册管理权限时，客户表单才可用。

门户按顺序处理活跃的营销活动：尝试解绑每个当前已分配的号码，停用营销活动，然后删除品牌。对于已标记为过期或已删除的营销活动，门户会跳过再次执行远程删除。这些外部步骤成功后，门户会在一个数据库事务中更新本地营销活动和号码记录。

这一系列步骤并不是涵盖注册机构、运营商和本地记录的单一原子事务。后续失败无法恢复已在外部更改的号码或营销活动。如有返回的已解绑号码和已停用营销活动详情，请予以保留；应根据这些标识符核对并处理状态差异，而不是另建品牌。

准备通过 API 直接删除

从允许的源 IP 地址，通过 HTTPS 使用已启用的 API 账户。品牌必须归该账户所有。读取并保留其标识符和当前状态，然后检查其营销活动和号码分配情况。删除品牌前，请解绑受影响的号码并停用营销活动。不要将此 DELETE 视为级联操作。

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

删除已核查的品牌

核对品牌标识符并完成上述清理后，仅针对计划停用的品牌执行以下操作。请求不含 JSON 正文。

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

文档规定的成功结果为 HTTP 204，且没有响应正文。不要要求返回 JSON 成功对象或旧版 v3 的 status/response 封装。被拒绝的非 2xx 结果不会通过当前 API 同步流程将品牌标记为已删除。

为计划执行的请求使用一个幂等键。重放请求时，方法、路径、查询和正文的字节内容均须保持不变。该键不会使门户更大范围的清理成为原子操作，也不能证明运营商号码已解绑。原请求仍在处理时收到的重复请求可能返回 409，并附带 Retry-After；已完成的请求可以重放其保存的响应，包括错误响应。

确认停用结果并核对部分完成的结果

操作完成后，检查门户中的品牌列表、营销活动列表以及受影响的号码。公开 API 的成功同步会在本地将该单个品牌标记为已删除；它不会移除其他营销活动资源，也不会清除已购买号码的分配。注册机构状态、运营商分配和本地显示需要分别检查。

当前门户运营商适配器会接受 HTTP 成功响应，而不会单独验证响应正文中的每个业务状态值。因此，门户清理后，即使门户报告成功，也应核查受影响号码实际所属的营销活动。如果分配或状态不一致，请保留受影响的标识符，并在通过已停用的配置发送消息或重新创建该配置之前联系支持人员。

对于 HTTP 400，请阅读注册机构的详细错误，尤其注意活跃营销活动的限制。对于 401、403 或 404，请检查凭据、允许的源 IP 和账户所有权。对于 429，请遵循 Retry-After。外部更改完成后仍可能出现超时、500 或 502；重复请求之前，请先检查现有注册。

检查账户剩余费用

当前 DELETE 服务不会发起即时品牌注册扣费。删除品牌不会释放租用的电话号码、发放退款或确定最终账户余额。请在门户中查看现有营销活动的费用承诺、号码租金和使用费。此操作并非对这些独立服务的报价。