激励视频完播上报
本接口应在服务器端调用,严禁在前端(APP 客户端、网页、小游戏等)直接调用,避免凭证泄露风险。
接口说明
接口英文名 ad.rewardNotify
功能描述 APP 服务端判断用户触发激励视频完播奖励事件后,调用此接口将数据上报至 SUD OP SVR,由 SUD OP 完成验证并通知 Game SVR 发奖。
注意:本接口强制要求服务通信二次加密和签名:请求参数必须加密并携带签名,响应必须验签后再解密,可有效防止数据篡改与泄露。
调用方式
HTTPS 调用
http
POST /v1/ad/reward/notify?access_token=ACCESS_TOKEN调用时,请在接口路径前拼接应用所属服务区域的基础地址,详见服务区域与接口地址。
请求参数 - Query
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| sud_transaction_id | string | 是 | SUD OP 通过 setServerSideVerificationData 透传,APP 服务端从 SSV 回调中原样取回 | |
| transaction_id | string | 是 | APP 平台下发的交易 ID,用于幂等去重 |
返回值
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误信息 |
| is_valid | boolean | true:上报成功,SUD OP 已受理并发起发奖流程;false:上报失败(如 sud_transaction_id 不存在或已处理) |
调用示例
说明:以下请求示例为加密前的业务数据,实际发送的是加密后的密文并携带签名请求头;返回示例为验签解密后的业务数据。封装与签名规则见服务端 API 签名加密。
请求数据示例
json
{
"sud_transaction_id": "2026042403100000000000001007",
"transaction_id": "tx_abc123"
}返回数据示例
json
{
"errcode": 0,
"errmsg": "success",
"is_valid": true
}