选择要查询的品牌
使用您账户中的品牌标识符。将其与返回的审核记录一并保存,以免将一家企业的审核误认为另一家企业的审核。请勿使用其他账户的标识符。
跟踪现有审核
请保留以下字段: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,并不表示营销活动已获批准、电话号码已分配,或已获准发送消息。