导入现有审核结果

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

从获准的源 IP 地址通过 HTTPS 使用已启用的 API 账户。支持 Basic 和 Bearer 身份验证。品牌 ID 必须归该账户所有。请对提供商令牌、品牌身份数据及返回的报告保密。

使用提供商的现有结果

使用 PUT 将受支持提供商的现有审核结果关联到您的品牌。此操作不会订购新的审核。请直接向该提供商获取正确的提供商交易 ID 以及所需的确认令牌，并确保报告对应同一企业身份。

AUTHPLUS 不支持此导入流程。提供商特定的匹配规则仍然适用；提交导入请求不会免除这些规则，也不保证满足每一种营销活动使用场景的资格要求。

准备导入

使用提供商的实际值创建 vetting-import.json。请勿提交仅供响应返回的评分、状态或时间戳字段，误以为它们可以更改结果。

导入结果一次

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

了解现有费用

此代理不会将新导入的结果记为新的付费订单。这不会取消此前订购的审核：如果同一个 vettingId 已有关联的订单正在等待结果或等待扣费，导入 ACTIVE 或 FAILED 结果可能会结算该订单已记录的费用。此同步分支不会对已扣费的记录再次扣费。

跟踪实际结果

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

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

重试同一预期请求

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

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