查询奖励发放状态
GET /v1/query-reward查询指定奖励发放记录的状态。
Request
通过 Query String 传递参数：
| Property | Type | Required | Description |
|---|---|---|---|
| game_id | string | True | 游戏 ID。 |
| partner_grant_reward_id | string | True | 合作方侧的奖励发放唯一标识。 |
示例：
GET /v1/query-reward?game_id=example_game&partner_grant_reward_id=grant_67890
Response
| Property | Type | Description |
|---|---|---|
| partner_grant_reward_id | string | 合作方传入的奖励发放标识。 |
| reward_status | string | 发放状态。取值见 reward_status 取值。 |
| rewarded_at | int64 | 发放成功时间，Unix 秒级时间戳。reward_status 为 failed 时为 0。 |
reward_status 取值
| 值 | 说明 |
|---|---|
success | 奖励已成功发放到角色游戏邮箱。 |
failed | 奖励发放失败，不可重试。使用相同的 partner_grant_reward_id 再次发放不会重新触发发放，将返回 failed_grant 错误。 |
示例：
{
"partner_grant_reward_id": "grant_67890",
"reward_status": "success",
"rewarded_at": 1714444800
}
Errors
| Error | Description |
|---|---|
| invalid_request | 请求参数缺失或格式错误。 |
| invalid_signature | 签名验证不通过。 |
| partner_disabled | 合作方已被禁用。 |
| reward_not_found | 未找到对应的奖励发放记录。可使用相同的 partner_grant_reward_id 重新发起 发放奖励。 |
| internal_error | 服务端内部错误。 |