订购品牌外部审核

使用归该账户所有的消息品牌

从获准的源 IP 地址通过 HTTPS 使用已启用的 API 账户。支持 Basic 和 Bearer 身份验证。品牌标识必须属于该账户。请对服务商令牌、品牌身份数据和返回的报告保密。

订购一次新的外部审核

需要审核服务商为该品牌进行一次新审核时，请使用 POST。如果已有服务商的审核结果，请改用导入。此操作不同于品牌身份重新验证。

请先读取品牌的当前记录并确认其身份信息。从当前目录中选择受支持的服务商和类别，并查看该服务商的要求。并非每个服务商都支持所有类别。政治审核所需的补充详情必须描述实际组织或竞选活动，不得使用示例数据。

准备提交给服务商的请求

外部审核订单字段
字段	值
evpId	必填的服务商标识，取自当前外部审核服务商目录，长度为 1–10 个字符。
vettingClass	您打算购买的受支持类别；请明确选择并确认其价格。
additionalRequestPayload	采用 JSON 编码、包含所选服务商专用详情的字符串，政治审核必须提供。它是外层 JSON 对象内的字符串，而非嵌套对象。请向所选服务商确认所有必需的详情。

确认成功和失败时的收费

以下为十月24日（2026年）查阅的现行零售费用，单位为美元。实际下单前，请确认最新金额。系统按成功结果的价格检查预付资金是否充足；必须已启用购买功能。

已配置的外部审核结果费用
类别	有效结果	失败结果
STANDARD	$46.12	$5.56
ENHANCED	$112.78	$6.67
POLITICAL	$73.34	$24.45
POLITICAL（附带 Express 请求）	$106.67	$24.45
AUTHPLUS	$13.89	$13.89
RCS	$83.34	$83.34

待处理订单会保留其成功和失败时各自的收费金额，并在同步到 ACTIVE 或 FAILED 结果时结算。最后两个类别对这两种最终结果采用相同的已配置费用。如果立即获得最终结果，可能在返回订单响应时收费。后续状态同步也可能结算待收费用。

不要将 mock:true 视为外部审核免费的保证。 当前外部审核结算流程仍可能记录该订单并收费。测试这些说明无需实际购买；在您打算授权付费审核之前，请使用离线测试样例。

提交一个已核查的订单

准备 vetting-order.json，填入服务商标识、类别及所有必需的补充信息。该文件包含实际打算提交的请求。请对其保密。

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

跟踪实际结果

成功的 HTTP 响应可能包含待处理的审核记录。请保留其 vettingId，并查看 vettingStatus 以及可用的原因、分数、生效日期和到期日期。PENDING 和 UNSCORE 需要继续跟进；ACTIVE、FAILED 和 EXPIRED 表示不同结果。仅在 HTTP 层面被接受，并不能证明评分良好或具备活动资格。

请使用外部审核状态跟踪该记录。读取或导入最终结果可能会结算之前的付费订单；这并不意味着一定不会收取已有的未结费用。

重试同一个预期请求

每项预期操作使用一个 Idempotency-Key，并原样保留方法、路径、查询参数和请求体字节。键支持 1–128 个可打印的 ASCII 字符，不得包含空格。对正在处理的操作重复发出请求，可能返回 409 并附带 Retry-After。已完成的请求会重放其存储的响应，包括错误。请遵守速率限制。

传输失败后可能返回缓存的 502 响应。带有 requestId 的缓存 500 响应可能意味着注册机构已接受该操作，但本地持久化存储或计费失败。请保留请求标识，检查当前记录，并在使用新键之前与支持团队核对处理及计费情况。不要认为出现错误就意味着订单不存在。