Skip to content

激励视频完播查询 ​

本接口为回调接口,由 APP 服务端实现并提供给 SUD 调用,SUD OP 在收到广告平台 SSV 回调后,将通过此接口向 APP 服务端确认用户的激励视频完播状态。

接口说明 ​

接口英文名 ad.rewardQuery

功能描述 激励视频完播查询。SUD OP 在收到广告平台 SSV 回调后,主动调用此接口向 APP 服务端确认用户的激励视频完播状态。

注意:本接口强制要求服务通信二次加密和签名:回调请求必须验签通过后才能处理业务,可有效防止数据篡改与泄露。

调用方式 ​

HTTPS 调用 ​

http
POST <APP 自定义回调地址>

请求参数 - Body ​

属性类型默认值必填说明
sud_transaction_idstring是本次激励视频完播唯一订单号,由 SUD OP 生成并在 setServerSideVerificationData 中透传

返回值 ​

返回的 JSON 数据包

属性类型说明
errcodeint32错误码
errmsgstring错误信息
transaction_idstringAPP 平台下发的完播订单号
statusint32视频状态,见下方枚举说明

errcode 的合法值 ​

值说明
0请求成功

status 枚举说明 ​

值枚举名说明
0PROCESSING视频进行中(未关闭,包含未开始播放、播放中等状态)
1COMPLETED已完播(视频关闭且完整播放完毕)
2INCOMPLETE未完播(视频关闭但未播放完毕)

SUD OP 仅在 status = 1 (COMPLETED) 时触发发奖流程。

调用示例 ​

说明:以下请求示例为解密后的业务数据,实际收到的是密文并携带签名请求头,须先验签、解密后再按此结构解析;返回示例为加密前的业务数据,实际返回须先加密、再对密文签名。完整规范见回调签名加密。

请求数据示例 ​

json
{
  "sud_transaction_id": "2026042403100000000000001007"
}

返回数据示例 ​

json
{
  "errcode": 0,
  "errmsg": "success",
  "transaction_id": "tx_abc123",
  "status": 1
}