开发者

GET/tcr/v2/brand/{brandId}/externalVetting

查看品牌审核结果

读取您账户下品牌的审核结果,并跟踪现有审核的进展,包括待处理、成功或失败的结果。

本页
  1. 选择要查询的品牌
  2. 跟踪现有审核
  3. 了解先前订单的费用
  4. 重试读取,无需提交新订单
  5. 分别处理各项注册步骤
  6. 请求
  7. 响应
  8. 错误
  9. 可用性及附带影响

选择要查询的品牌

使用您账户中的品牌标识符。将其与返回的审核记录一并保存,以免将一家企业的审核误认为另一家企业的审核。请勿使用其他账户的标识符。

跟踪现有审核

请保留以下字段:vettingId、evpId、vettingClass和vettingStatus(如有)。当前同步逻辑将 PENDING 和 UNSCORE 视为仍待进一步核查的结果,并将 ACTIVE 和 FAILED 视为可用于结算的最终结果。在决定是否需要后续操作之前,请阅读返回的详细信息。仅凭空列表,不能证明之前提交的请求未到达注册机构。

了解先前订单的费用

查询状态不会下达新的审核订单。不过,此操作可能核对已完成的结果,并结算先前收费审核请求对应的费用,包括适用的审核失败费用。请以订购时查看的价格和条款为准;不要根据旧示例或状态响应推断当前价格。

重试读取,无需提交新订单

如遇暂时性故障,请保留品牌标识符和已知的审核标识符,遵循 Retry-After 的要求,并逐步延长重试间隔后再次读取。不要仅因状态查询失败或返回了非预期的响应体,就提交新的审核订单。如果不一致问题持续存在,请通过经过身份验证的支持渠道联系 MultiTEL,并提供相关参考标识符。

分别处理各项注册步骤

品牌审核用于确定该品牌的审核结果。营销活动资格审核、营销活动注册和号码分配仍是独立的步骤。发送消息之前,请检查这些步骤的当前状态和要求。

请求

请从获准的源 IP 地址,通过 HTTPS 使用已启用 API 的账户。使用您账户的凭据,而非注册机构的凭据。该品牌必须关联到已通过身份验证的账户。

发送 GET 请求时,在路径中包含品牌标识符,并提供必填的 vettingStatus 查询筛选条件。已审查的数据结构将状态定义为数组;本示例请求单个 ACTIVE 值。本指南尚未确认多值编码方式,也未确认提供方是否接受不带筛选条件的请求。无需请求体。

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting?vettingStatus=ACTIVE"
路径参数
名称类型必填说明
brandId字符串是与您的 MultiTEL 账户关联的注册机构品牌标识符。这不是您的账户标识符,也不是审核标识符。
查询参数
名称类型必填说明
vettingStatus字符串数组是必填的状态筛选条件。允许的值:PENDING、UNSCORE、ACTIVE、FAILED、EXPIRED。本示例提供单个 ACTIVE 值;不对多值编码方式或提供方是否接受不带筛选条件的请求作出保证。

响应

当前路由保留注册机构的 HTTP 状态和响应体,不使用旧版 v3 响应封装。这个简化的虚构数组展示了本地同步流程使用的字段;它并非实际捕获的注册机构响应,也不保证展示完整的数据结构。读取记录之前,请检查 HTTP 状态和 JSON。请将每个 vettingId 与所选品牌一并保存。

仅用于说明响应结构;并非账户实时数据或当前报价。

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

错误

  • 401: 账户身份验证失败。请检查凭据、API 是否已启用,以及适用的源 IP 限制。
  • 404: 该品牌未关联到此账户,或注册机构未能找到该品牌。因账户归属校验而拒绝访问的情况发生在向注册机构发送请求之前。
  • 429: 已达到账户或注册机构的请求限制。请遵循 Retry-After 的要求,并逐步延长重试间隔。
  • 502/503: 传输、注册机构、请求限流组件或本地处理不可用。出现错误并不能证明先前的审核请求已失败。

可用性及附带影响

  • 此 GET 不会下达新的审核订单。它会获取注册机构的结果、写入请求审计记录,并同步已存储的结果。
  • 读取已完成的结果可能会结算先前已下达的收费审核订单的费用。审核失败时,可能会收取适用的失败费用。请在订购时查看价格和条款;此次读取不构成报价。
  • 通过此 GET 导入的新发现记录,不会自动被归类为新的收费订单。
  • 审核成功或结果为 ACTIVE,并不表示营销活动已获批准、电话号码已分配,或已获准发送消息。