查看品牌可用的活动用途

选择您账户中的现有品牌

请使用已关联到您 MultiTEL 账户的注册机构品牌 ID。此查询不会创建品牌，也不会将他人的品牌关联到您的账户。当前客户流程会在请求资格信息之前检查所有权。如果查询返回 404，请核实所选账户和品牌，不要改用本地数据行 ID。

根据此结果生成用途选项

通用用途目录介绍注册机构提供的选项。此品牌专属查询提供所选品牌可用的选项。请保留返回的每个 usecase 值，并结合目录中的显示名称和说明使用。不要将通用目录中的所有条目都作为该品牌已具备资格的选项提供。

门户要求此响应为 JSON 列表。如果响应缺失、格式不正确或返回错误，请保留客户的表单，并提示无法加载资格信息。不要在不作提示的情况下将其视为默认用途已获批准。注册机构可能返回简略示例之外的字段。

加载所选用途的要求

客户选择返回的某个用途值后，请针对同一品牌请求 /tcr/v2/campaignBuilder/brand/{brand_id}/usecase/{usecase}。该响应提供子用途的范围限制以及各运营商的具体要求。请据此收集消息示例、同意授权及其他必需声明。仅凭资格列表不足以构建完整的活动注册申请。

单独核对账户价格

提供商字段，例如 monthlyFee、quarterlyFee 或 annualFee，在返回时用于描述提供商费用元数据。这些字段不能替代客户的账户价格或注册条款。当前门户会单独读取活动零售价格，并在核对页面中将其与资格数据结合显示。不要根据旧枚举辅助程序中硬编码的价格推断客户应付费用。

品牌或用途变更时刷新信息

切换品牌时，请清除上一品牌的选项，并加载新选品牌的资格信息。提交前请刷新所选用途的要求。这些 GET 请求不会提交注册申请、激活活动或分配号码。

请求

请从获准的来源 IP 地址，通过 HTTPS 使用已启用的 API 账户。当前路由支持账户身份验证策略，包括 Basic 身份验证和已启用的持有者令牌 API 账户。请勿使用提供商凭据。

在 URL 路径中指定品牌标识符，发送 GET 请求。无需请求正文。

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

响应

当前 TCR 路由直接返回注册机构的 JSON 正文，并保留其 HTTP 状态。它不会添加旧版 v3 的 status/response 封装。此简略虚构示例并非实时资格查询结果。使用前请检查 HTTP 状态及预期的 JSON 结构。当前门户要求返回资格记录列表，每条记录标识一个 usecase。门户将这些记录与 usecase 目录结合以获取显示名称，并单独读取零售价格。响应中可能包含其他提供商字段。

响应结构示例；并非实时账户数据或当前报价。

[
  {
    "usecase": "2FA"
  }
]

错误

• 401: 账户身份验证失败。请检查 API 凭据、账户启用状态及适用的来源 IP 限制。
• 404: 品牌未关联到已通过身份验证的账户，或者提供商找不到所请求的品牌或所选项。如果本地所有权检查拒绝访问，会在向提供商发送请求之前返回拒绝结果。
• 其他注册机构错误：保留上游的 HTTP 状态和正文。用途无效或不可用，不代表已成功获取到空的要求集合。
• 429: 已达到账户或共享提供商的请求上限。请遵循 Retry-After。
• 502/503: 传输、提供商或限流器发生可用性故障。请保留表单，并逐步延长等待间隔后重试。

可用性及附带影响

• 经审查的 GET 会检查现有品牌的所有权、联系注册机构并写入请求审计记录。它不会创建品牌或活动，也不会收取注册费。
• 提供商费用元数据并非面向 MultiTEL 客户的零售报价。在后续发送注册请求之前，门户会单独核对账户价格。
• 资格和要求可能发生变化。提交前请刷新所选品牌和用途的相关信息。查询成功不代表活动已获批准、号码已分配，也不代表已获准开始发送消息。