激励视频完播查询
本接口为回调接口,由 APP 服务端实现并提供给 SUD 调用,SUD OP 在收到广告平台 SSV 回调后,将通过此接口向 APP 服务端确认用户的激励视频完播状态。
接口说明
接口英文名 ad.rewardQuery
功能描述 激励视频完播查询。SUD OP 在收到广告平台 SSV 回调后,主动调用此接口向 APP 服务端确认用户的激励视频完播状态。
注意:本接口强制要求服务通信二次加密和签名:回调请求必须验签通过后才能处理业务,可有效防止数据篡改与泄露。
调用方式
HTTPS 调用
http
POST <APP 自定义回调地址>请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| sud_transaction_id | string | 是 | 本次激励视频完播唯一订单号,由 SUD OP 生成并在 setServerSideVerificationData 中透传 |
返回值
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误信息 |
| transaction_id | string | APP 平台下发的完播订单号 |
| status | int32 | 视频状态,见下方枚举说明 |
errcode 的合法值
| 值 | 说明 |
|---|---|
| 0 | 请求成功 |
status 枚举说明
| 值 | 枚举名 | 说明 |
|---|---|---|
| 0 | PROCESSING | 视频进行中(未关闭,包含未开始播放、播放中等状态) |
| 1 | COMPLETED | 已完播(视频关闭且完整播放完毕) |
| 2 | INCOMPLETE | 未完播(视频关闭但未播放完毕) |
SUD OP 仅在
status = 1 (COMPLETED)时触发发奖流程。
调用示例
说明:以下请求示例为解密后的业务数据,实际收到的是密文并携带签名请求头,须先验签、解密后再按此结构解析;返回示例为加密前的业务数据,实际返回须先加密、再对密文签名。完整规范见回调签名加密。
请求数据示例
json
{
"sud_transaction_id": "2026042403100000000000001007"
}返回数据示例
json
{
"errcode": 0,
"errmsg": "success",
"transaction_id": "tx_abc123",
"status": 1
}