# 目录 1. [dailyCheckIn 对象定义](#daily-checkin-object) 2. [签到活动详情](#page-info) 3. [个人页面签到概览](#gift-overview) 4. [执行今日签到](#sign) 5. [执行历史补签](#patch-sign) 6. [查询签到历史](#histories) 7. [查询奖励状态](#reward-status-api) 8. [查询连续签到奖励状态](#continuous-reward-status) 9. [领取普通奖励](#claim-reward) 10. [领取场馆盲盒奖励](#claim-blind-box) 11. [领取连续签到奖励](#claim-continuous-reward) # dailyCheckIn 对象定义 dailyCheckIn 是 pageInfo.data 下的新签到活动概览对象，结构与 giftOverview.data 一致。 ## dailyCheckIn 字段 | 字段 | 类型 | 说明 | |---|---|---| | enabled | boolean | 新签到活动是否启用 | | activityId | int64 | 当前运营活动 ID | | activityTitle | string | 活动标题 | | checkedInToday | boolean | 当前会员今天是否已经签到 | | currentStreak | int | 当前连续签到天数 | | totalCheckInDays | int | 当前活动累计签到天数 | | continuousRewards | array | 连续签到奖励节点，元素结构见下表 | | cumulativeRewards | array | 累计签到奖励节点，元素结构与 continuousRewards 相同 | | serverBizDate | string | 服务端业务日期，格式 YYYY-MM-DD | | days | array | 签到日期数据，元素结构见下表 | ## days[] 字段 | 字段 | 类型 | 说明 | |---|---|---| | bizDate | string | 业务日期，格式 YYYY-MM-DD | | dateLabel | string | 展示日期，格式 MM.dd | | rewardType | int | 1 普通奖励，2 盲盒奖励 | | rewardAmount | string | 当日奖励金额 | | rewardText | string | 奖励展示文本 | | status | string | 日期状态：EXPIRED、SIGNED、AVAILABLE、PENDING | | patchStatus | string | 补签状态：AVAILABLE、PATCHED、UNAVAILABLE | | rewardStatus | string，条件返回 | 当日奖励订单状态；为空时字段省略 | ## continuousRewards[] / cumulativeRewards[] 字段 | 字段 | 类型 | 说明 | |---|---|---| | enabled | boolean | 奖励节点是否启用 | | targetDays | int | 达标所需天数 | | currentDays | int | 当前已经累计的天数 | | rewardAmount | string | 节点奖励金额 | | status | string | 节点当前进度或领取状态 | | rewardStatus | string | 该节点对应的奖励订单状态 | | claimable | boolean | 当前是否满足领取条件 | | orderNo | string | 对应奖励订单号；没有订单时返回空字符串 | | walletCategory | int | 奖励钱包类别 | # 获取签到活动详情 ## 接口用途用于签到活动详情页面。客户端根据 activityId 获取指定签到活动的页面配置、当前用户签到状态和完整 dailyCheckIn 数据；未登录时仅返回可公开展示的活动概览。 ## 请求 ~~~http POST /act/api/v1/activitySignGift/pageInfo ~~~ 请求体： ~~~json { "activityId": 3510004 } ~~~ | 字段 | 类型 | 必填 | 说明 | |---|---|---:|---| | activityId | int64 | 是 | 签到活动 ID | | bizDate | string | 否 | 业务日期，部分兼容场景使用，格式 YYYY-MM-DD | | venueId | string | 否 | 场馆奖励场景使用；本接口通常不需要 | 请求头：Content-Type: application/json、SSYY-Site-Id、SSYY-Client-Type；登录用户还应携带 SSYY-Token。 ## 返回结构 ~~~json { "data": { "enabled": true, "checkedInToday": false, "vipLevel": 0, "todayBaseBonus": "0.00", "currentStreak": 0, "nextMilestoneDays": 3, "nextMilestoneBonus": "5.00", "nextCumulativeDays": 7, "nextCumulativeBonus": "10.00", "todayResult": null, "serverBizDate": "2026-08-20", "configId": 0, "checkInType": "FREE", "dailyCheckIn": { "enabled": true, "activityId": 3510004, "days": [] } }, "message": "success", "status_code": 6000 } ~~~ ## data 字段 | 字段 | 类型 | 说明 | |---|---|---| | enabled | boolean | 当前签到状态接口是否启用 | | checkedInToday | boolean | 今天是否已经签到 | | vipLevel | int | 查询时的会员 VIP 等级 | | todayBaseBonus | string | 今日基础奖励金额 | | currentStreak | int | 当前连续签到天数 | | nextMilestoneDays | int 或 null | 下一个连续签到奖励所需天数 | | nextMilestoneBonus | string 或 null | 下一个连续签到奖励金额 | | nextCumulativeDays | int 或 null | 下一个累计签到奖励所需天数 | | nextCumulativeBonus | string 或 null | 下一个累计签到奖励金额 | | todayResult | object 或 null | 今日签到结果；未签到时通常为空 | | serverBizDate | string | 服务端业务日期 | | configId | int64 | 签到配置 ID | | checkInType | string | 签到类型，当前活动通常为 FREE | | dailyCheckIn | object 或 null | 新签到活动的完整概览，结构与 giftOverview 的 data 相同 | ## 登录与兼容规则 - 新签到活动：当活动 ID 属于新签到配置时，接口返回 dailyCheckIn；已登录用户同时返回 Status 字段。 - 未登录访问新签到活动：可以返回公开的 dailyCheckIn 概览，但不应据此判断用户已签到或奖励已到账。 - 旧签到活动：必须携带有效 Token；无 Token 按登录校验失败处理，并返回旧版页面信息结构。 - status_code=6000 只表示接口处理成功；奖励到账仍需结合 rewardStatus 查询结果确认。 ## 推荐调用流程 1. 进入签到活动详情页面时，提交 activityId 查询该活动的详情信息。 2. 若 dailyCheckIn 存在，优先使用其中的 days、currentStreak、continuousRewards 和 cumulativeRewards。 3. 根据 days[].status 判断签到或补签条件；签到、补签后重新请求本接口刷新页面。 4. 领取奖励后，再结合 rewardStatus 接口查询订单状态。 # 获取个人页面签到概览 ## 接口用途用于个人页面展示当前用户的签到概览，包括今日签到状态、签到日历、连续签到进度、累计签到进度和奖励状态。该接口不用于打开某个指定活动的详情页面。 ~~~http POST /act/api/v1/dailyCheckIn/giftOverview ~~~ ## 请求体接口不需要业务请求参数，使用空 JSON： ~~~json {} ~~~ ## 请求头 | 请求头 | 示例 | 必填 | 说明 | |---|---|---:|---| | Content-Type | application/json | 是 | JSON 请求 | | SSYY-Site-Id | 1000 | 是 | 站点 ID | | SSYY-Client-Type | h5 | 是 | 客户端类型 | | SSYY-Token | 用户登录 Token | 否 | 不传时返回公开活动配置；传入有效 Token 后返回用户签到状态 | ## 返回结构 ~~~json { "data": { "enabled": true, "activityId": 3510004, "activityTitle": "签到领好礼", "checkedInToday": false, "currentStreak": 2, "totalCheckInDays": 5, "continuousRewards": [], "cumulativeRewards": [], "serverBizDate": "2026-08-20", "days": [] }, "message": "success", "status_code": 6000 } ~~~ ## data 字段 | 字段 | 类型 | 说明 | |---|---|---| | enabled | boolean | 签到模块是否启用 | | activityId | int64 | 当前活动 ID | | activityTitle | string | 活动标题 | | checkedInToday | boolean | 今天是否已经签到 | | currentStreak | int | 当前连续签到天数 | | totalCheckInDays | int | 当前活动累计签到天数 | | continuousRewards | array | 连续签到奖励节点 | | cumulativeRewards | array | 累计签到奖励节点 | | serverBizDate | string | 服务端业务日期，格式 YYYY-MM-DD | | days | array | 独立 giftOverview 当前最多返回 6 个活动日期窗口；兼容 pageInfo 的 dailyCheckIn 可返回活动配置范围内的全部日期 | ## days[] 字段 | 字段 | 类型 | 说明 | |---|---|---| | bizDate | string | 业务日期，格式 YYYY-MM-DD | | dateLabel | string | 展示日期，格式 MM.dd | | rewardType | int | 1 普通红包，2 盲盒红包 | | rewardAmount | string | 奖励金额 | | rewardText | string | 奖励展示文本 | | status | string | 日期状态：EXPIRED、SIGNED、AVAILABLE、PENDING | | patchStatus | string | 补签状态：AVAILABLE、PATCHED、UNAVAILABLE | | rewardStatus | string，条件返回 | 该日期奖励的发放状态；为空时字段直接省略 | ## continuousRewards[] / cumulativeRewards[] 字段 | 字段 | 类型 | 说明 | |---|---|---| | enabled | boolean | 奖励节点是否启用 | | targetDays | int | 达标所需天数 | | currentDays | int | 当前已累计天数 | | rewardAmount | string | 节点奖励金额 | | status | string | LOCKED、PENDING、CLAIMABLE、CLAIMED | | rewardStatus | string | 连续/累计奖励的领取或发放状态 | | claimable | boolean | 是否可以调用对应领取接口 | ## 登录态差异 - 未登录：返回活动配置、签到日期和奖励节点，不返回用户实际签到状态。 - 已登录：根据 Token 返回 checkedInToday、currentStreak、days 状态和奖励发放状态。 - Token 无效：按登录校验失败处理，不应把响应当作用户签到成功。 ## 推荐调用时机 1. 进入个人页面或个人中心的签到入口区域时调用一次。 2. 执行签到或补签后重新调用，刷新 days 和 currentStreak。 3. 领取普通钱包、场馆钱包或连续签到奖励后重新调用。 4. 网络超时不要重复签到，先重新查询本接口确认记录状态。 ## 结果判断 - status_code=6000：接口处理成功，读取 data。 - status_code 非 6000：展示 message，不自行判定签到或奖励成功。 - 真正确认奖励到账，还需要结合 rewardStatus 查询到 SUCCESS。 # 执行今日签到 ## 接口用途执行当前会员的新活动今日签到。本文返回值仅覆盖 activityId 命中新签到配置后的 dailyCheckIn Result。 ## 请求 ~~~http POST /act/api/v1/activitySignGift/sign ~~~ 请求体： ~~~json { "activityId": 3510004 } ~~~ | 字段 | 类型 | 必填 | 说明 | |---|---|---:|---| | activityId | int64 | 是 | 签到活动 ID | 请求头：Content-Type: application/json、SSYY-Site-Id、SSYY-Client-Type、SSYY-Token。此接口必须携带有效登录 Token。 ## 新签到活动返回字段 ~~~json { "data": { "returnFlg": 0, "success": true, "alreadyCheckedIn": false, "bizDate": "2026-08-20", "vipLevelSnapshot": 0, "baseBonus": "1.00", "milestoneDays": null, "milestoneBonus": "0.00", "cumulativeDays": null, "cumulativeBonus": "0.00", "totalBonus": "1.00", "bonus": 1, "currentStreak": 1, "orderNo": "订单号", "checkInType": "FREE", "rewardStatus": "SIGNED_UNCLAIMED", "rewardType": 1, "blindBoxItemId": 0, "walletCategory": 1, "venueIds": "", "selectedVenueId": "", "flowTimes": 1, "isPatch": 0 }, "message": "签到成功", "status_code": 6000 } ~~~ | 字段 | 类型 | 说明 | |---|---|---| | returnFlg | int | 业务处理标志；0 通常表示成功 | | success | boolean | 本次签到是否成功 | | alreadyCheckedIn | boolean | 今天是否已经签到 | | bizDate | string | 签到业务日期，格式 YYYY-MM-DD | | vipLevelSnapshot | int | 签到时会员 VIP 快照 | | baseBonus | string | 基础奖励金额 | | milestoneDays | int 或 null | 命中的连续签到天数 | | milestoneBonus | string | 连续签到奖励金额 | | cumulativeDays | int 或 null | 命中的累计签到天数 | | cumulativeBonus | string | 累计签到奖励金额 | | totalBonus | string | 本次签到奖励总额 | | bonus | number | totalBonus 的数值兼容字段 | | currentStreak | int | 签到后的连续签到天数 | | orderNo | string | 奖励订单号，用于后续查询奖励状态 | | checkInType | string | 签到类型，通常为 FREE | | rewardStatus | string | 奖励状态，如 PENDING、PROCESSING、SUCCESS、FAILED、SIGNED_UNCLAIMED | | rewardType | int | 1 普通奖励，2 盲盒奖励 | | blindBoxItemId | int64 | 盲盒奖项 ID；非盲盒通常为 0 | | walletCategory | int | 钱包类别 | | venueIds | string | 可用场馆 ID 列表，场馆奖励时使用 | | selectedVenueId | string | 已选择场馆 ID，未选择时为空 | | flowTimes | int | 奖励流水倍数 | | isPatch | int | 是否补签，正常签到通常为 0 | | venueList | array，条件返回 | 仅需要选择场馆且列表非空时返回，元素包含 venueId、venueName | ## 条件与异常处理 - Token 无效或缺失：返回登录校验失败，不执行签到。 - activityId 小于 1 或请求体 JSON 无效：返回参数错误。 - alreadyCheckedIn=true：不要重复提交，先调用 pageInfo 或 giftOverview 刷新状态。 - 新活动返回 rewardStatus 为 PENDING、PROCESSING 等中间状态时，不要直接判定奖励到账；使用 orderNo 调用 rewardStatus。 - rewardType=2 或返回 venueList 时，后续领取盲盒场馆奖励必须使用合法 venueId。 - 新签到分支的资格、配置或执行失败会转换为 Result，并通过 status_code=6000 返回；此时 success=false，必须读取 returnFlg 和 message。 - JSON、activityId 或 Token 等前置校验失败通常返回非 6000 的 status_code。 - status_code=6000 只表示接口已完成业务处理；最终奖励到账仍以 rewardStatus=SUCCESS 为准。 # 执行历史补签 ## 接口用途为新签到活动的指定历史业务日期执行补签。本文返回值仅覆盖 activityId 命中新签到配置后的 dailyCheckIn Result。 ## 请求 ~~~http POST /act/api/v1/activitySignGift/patchSign ~~~ 请求体： ~~~json { "activityId": 3510004, "patchSignDay": "2026-08-19" } ~~~ | 字段 | 类型 | 必填 | 说明 | |---|---|---:|---| | activityId | int64 | 是 | 签到活动 ID | | patchSignDay | string | 是 | 要补签的业务日期，格式 YYYY-MM-DD | 请求头：Content-Type: application/json、SSYY-Site-Id、SSYY-Client-Type、SSYY-Token。接口必须携带有效登录 Token。 ## 返回结构新签到活动返回完整 Result，字段与 sign 的“新签到活动返回字段”一致。下面列出补签重点字段；venueList 仍为条件返回： | 字段 | 类型 | 说明 | |---|---|---| | returnFlg | int | 业务处理标志；0 通常表示成功 | | success | boolean | 补签是否成功 | | alreadyCheckedIn | boolean | 目标日期是否已经签到或补签 | | bizDate | string | 实际补签业务日期 | | totalBonus | string | 本次补签奖励总额 | | currentStreak | int | 补签处理后的连续签到天数 | | orderNo | string | 奖励订单号 | | rewardStatus | string | PENDING、PROCESSING、SUCCESS、FAILED、SIGNED_UNCLAIMED 等状态 | | rewardType | int | 1 普通奖励，2 盲盒奖励 | | isPatch | int | 是否补签；成功补签通常为 1 | | venueList | array | 场馆奖励可选项，包含 venueId、venueName | ## 补签条件 - Token 必须有效，activityId 必须大于 0。 - patchSignDay 必须是合法的 YYYY-MM-DD 日期。 - 活动必须开启补签功能，目标日期必须在允许补签范围内。 - 目标日期不能已经签到或已经补签；历史补签记录状态为已过期时不能重复补签。 - 需要满足活动的补签次数、周期和风控规则；当前日期与补签日期不在允许周期内时会失败。 - 新签到活动还会根据该日期的奖励配置生成奖励；场馆盲盒奖励后续领取必须使用返回的合法 venueId。 ## 常见失败处理 - 参数缺失或日期格式错误：返回参数错误。 - 补签功能关闭、日期超范围、次数用尽或目标日期不可补签：展示 message，不要重复提交。 - 返回 alreadyCheckedIn=true：先刷新 pageInfo 或 giftOverview，不要再次补签。 - status_code=6000 只表示接口处理成功；最终奖励到账仍需根据 orderNo 查询 rewardStatus。 # 查询签到历史 ## 1. 接口用途查询当前登录会员在每日签到活动中的签到、补签、连续奖励和累计奖励历史。接口只读取历史记录，不执行签到、补签、领取或发奖。 ~~~http POST /act/api/v1/dailyCheckIn/history ~~~ ## 2. 请求头 | Header | 必填 | 说明 | |---|---:|---| | Content-Type | 是 | application/json | | SSYY-Site-Id | 是 | 当前站点 ID | | SSYY-Client-Type | 是 | 客户端类型 | | SSYY-Token | 是 | 当前登录会员 Token；只返回该会员的数据 | ## 3. 请求体 ~~~json { "opActId": 3510004, "checkInType": "FREE", "type": "SIGN", "pageNo": 1, "pageSize": 20 } ~~~ | 字段 | 类型 | 必填 | 默认值或限制 | 产品作用 | |---|---|---:|---|---| | opActId | int64 | 是 | — | 通过运营活动 ID 定位签到配置 | | checkInType | string | 否 | 空值按 FREE 处理；当前仅支持 FREE | 签到类型 | | type | string | 否 | 空字符串表示全部 | 筛选签到或奖励历史 | | pageNo | int | 否 | 小于 1 自动改为 1 | 当前页 | | pageSize | int | 否 | 小于 1 或大于 100 自动改为 20 | 每页条数 | ## 4. type 查询范围 | type | 查询条件 | 返回内容 | |---|---|---| | 空字符串 | 合并签到记录和奖励记录 | 全部签到及奖励历史 | | SIGN | 排除连续与累计奖励业务记录 | 普通签到和补签历史 | | PATCH | isPatch=1 | 仅补签历史 | | CONTINUOUS | milestoneDays 非空 | 连续签到里程碑奖励 | | CUMULATIVE | cumulativeDays 非空 | 累计签到奖励 | | 其他值 | 不执行历史查询 | 返回“历史记录类型不支持” | ## 5. 返回示例 ~~~json { "data": { "list": [ { "orderNo": "ASG123456789", "rewardStatus": "SIGNED_UNCLAIMED", "bizDate": "2026-08-20", "checkInType": "FREE", "bonus": 1, "flowTimes": 8, "isPatch": 0, "walletCategory": 1, "selectedVenueId": "", "milestoneDays": null, "cumulativeDays": null } ], "total": 1, "pageNo": 1, "pageSize": 20 }, "message": "success", "status_code": 6000 } ~~~ ## 6. data 分页字段 | 字段 | 类型 | 含义 | 客户端处理 | |---|---|---|---| | data.list | array | 当前页历史记录 | 空数组时展示无记录 | | data.total | int | 去重后的总记录数 | 用于分页 | | data.pageNo | int | 服务端修正后的当前页 | 以返回值为准 | | data.pageSize | int | 服务端修正后的每页条数 | 以返回值为准 | ## 7. list[] 完整字段 | 字段 | 类型 | 含义 | 客户端处理 | |---|---|---|---| | orderNo | string | 奖励订单号 | 非空时可传给 rewardStatus | | rewardStatus | string | 奖励发放状态 | 决定领取、等待、成功或失败展示 | | bizDate | string | 业务日期 | 作为历史记录日期 | | checkInType | string | 签到类型 | 区分 FREE 等配置类型 | | bonus | number | 该条历史记录的奖励金额 | 金额展示 | | flowTimes | int | 奖励流水倍数 | 展示流水要求 | | isPatch | int | 1 补签，0 普通签到或奖励 | 展示补签标识 | | walletCategory | int | 钱包类型 | 1 中心钱包，2 场馆钱包 | | selectedVenueId | string | 已选择的场馆 ID | 展示场馆钱包到账位置 | | milestoneDays | int 或 null | 连续签到节点天数 | 非空表示连续奖励记录 | | cumulativeDays | int 或 null | 累计签到节点天数 | 非空表示累计奖励记录 | 历史响应使用精简结构，不返回 success、alreadyCheckedIn、totalBonus、currentStreak、rewardType、venueList 等签到操作字段。 ## 8. rewardStatus 状态处理 | rewardStatus | 含义 | 客户端动作 | |---|---|---| | SIGNED_UNCLAIMED | 已生成奖励，尚未领取 | 根据 walletCategory 进入领取流程 | | PENDING | 奖励等待处理 | 等待后查询 | | PROCESSING | 奖励发放中 | 不重复领取，使用 orderNo 查询状态 | | SUCCESS | 已发放成功 | 展示到账 | | FAILED | 发放失败 | 展示失败，按业务规则处理 | status_code=6000 只表示历史查询成功；奖励最终到账必须以 rewardStatus=SUCCESS 为准。 # 查询奖励状态 ## 接口用途根据签到、补签或奖励领取接口返回的 orderNo，查询当前会员对应奖励订单的最新状态。接口会按订单重新读取记录并补偿处理中的奖励，因此用于确认奖励是否最终到账。 ## 请求 ~~~http POST /act/api/v1/dailyCheckIn/rewardStatus ~~~ 请求体： ~~~json { "orderNo": "签到接口返回的订单号" } ~~~ | 字段 | 类型 | 必填 | 说明 | |---|---|---:|---| | orderNo | string | 是 | sign、patchSign、claimReward 或其他领取接口返回的奖励订单号 | 请求头：Content-Type: application/json、SSYY-Site-Id、SSYY-Client-Type、SSYY-Token。必须携带当前会员的有效 Token；订单只能查询当前会员自己的记录。 ## 返回示例 ~~~json { "data": { "returnFlg": 0, "success": true, "alreadyCheckedIn": true, "bizDate": "2026-08-20", "vipLevelSnapshot": 0, "baseBonus": "1.00", "milestoneDays": 3, "milestoneBonus": "5.00", "cumulativeDays": null, "cumulativeBonus": "0.00", "totalBonus": "6.00", "bonus": 6, "currentStreak": 3, "orderNo": "订单号", "checkInType": "FREE", "rewardStatus": "SUCCESS", "rewardType": 1, "blindBoxItemId": 0, "walletCategory": 1, "venueIds": "", "selectedVenueId": "", "flowTimes": 1, "isPatch": 0 }, "message": "success", "status_code": 6000 } ~~~ ## data 字段 | 字段 | 类型 | 说明 | |---|---|---| | returnFlg | int | 业务处理标志 | | success | boolean | 本次签到或奖励处理是否成功 | | alreadyCheckedIn | boolean | 对应签到记录是否已经存在 | | bizDate | string | 业务日期，格式 YYYY-MM-DD | | vipLevelSnapshot | int | 记录创建时的会员 VIP 快照 | | baseBonus | string | 基础奖励金额 | | milestoneDays | int 或 null | 命中的连续签到奖励天数 | | milestoneBonus | string | 连续签到奖励金额 | | cumulativeDays | int 或 null | 命中的累计签到奖励天数 | | cumulativeBonus | string | 累计签到奖励金额 | | totalBonus | string | 该记录奖励总额 | | bonus | number | totalBonus 的数值兼容字段 | | currentStreak | int | 当前连续签到天数 | | orderNo | string | 查询使用的奖励订单号 | | checkInType | string | 签到类型，通常为 FREE | | rewardStatus | string | 当前奖励发放状态 | | rewardType | int | 1 普通奖励，2 盲盒奖励 | | blindBoxItemId | int64 | 盲盒奖项 ID；非盲盒通常为 0 | | walletCategory | int | 钱包类别 | | venueIds | string | 可用场馆 ID 列表 | | selectedVenueId | string | 已选择的场馆 ID | | flowTimes | int | 流水倍数 | | isPatch | int | 是否补签，1 表示补签 | | venueList | array，条件返回 | walletCategory=2 且 venueIds 非空时返回；元素包含 venueId、venueName，enName 非空时返回 | ## rewardStatus 状态 | 状态 | 含义 | 客户端处理 | |---|---|---| | PENDING | 已创建订单，等待处理 | 继续查询，不判定到账 | | PROCESSING | 正在发放 | 继续查询，不重复领取 | | SUCCESS | 发放成功 | 可以展示奖励到账 | | FAILED | 发放失败 | 展示失败信息并按业务策略重试或联系后台 | | SIGNED_UNCLAIMED | 已签到但奖励尚未领取 | 需要进入对应领取流程 | NONE 不是本 rewardStatus 接口的订单状态；订单不存在时接口返回业务失败。NONE 只用于 claimContinuousReward 表示没有可领取的连续奖励。 ## 使用流程与异常处理 1. 调用 sign 或 patchSign，读取响应中的 orderNo。 2. 立即调用本接口查询状态；PENDING 或 PROCESSING 时按间隔轮询。 3. 只有 rewardStatus=SUCCESS 才能确认奖励到账。 4. orderNo 为空、订单不存在、Token 无效或订单不属于当前会员时，接口返回失败。 5. rewardType=2、rewardStatus=SIGNED_UNCLAIMED 且 walletCategory=2 时，使用返回的 venueList 选择 venueId，再调用场馆盲盒领取接口。 6. 不要因为 status_code=6000 就直接判定奖励到账；必须同时检查 success 和 rewardStatus。 # 查询连续签到奖励状态 ## 接口用途查询当前会员的连续签到里程碑进度。它返回连续奖励节点和是否可领取的信息，可按 orderNo 缩小到某一笔连续奖励；与 rewardStatus 查询单个奖励订单的最终发放状态不同。 ## 请求 ~~~http POST /act/api/v1/dailyCheckIn/continuousRewardStatus ~~~ 请求体： ~~~json { "activityId": 3510004, "checkInType": "FREE", "orderNo": "" } ~~~ | 字段 | 类型 | 必填 | 说明 | |---|---|---:|---| | activityId | int64 | 新活动必填 | 活动 ID；未传 opActId 时作为 opActID 使用 | | opActId | int64 | 兼容可选 | 旧字段名，优先用于定位活动 | | configId | int64 | 否 | 已知签到配置 ID | | checkInType | string | 否 | 签到类型，通常为 FREE | | orderNo | string | 否 | 指定某个连续奖励订单；为空时返回全部连续奖励节点 | 请求头：Content-Type: application/json、SSYY-Site-Id、SSYY-Client-Type、SSYY-Token。必须携带有效登录 Token。 ## 返回示例 ~~~json { "data": { "activityId": 3510004, "enabled": true, "checkedInToday": true, "currentStreak": 3, "walletCategory": 1, "continuousRewards": [ { "enabled": true, "targetDays": 3, "currentDays": 3, "rewardAmount": "5.00", "status": "CLAIMABLE", "rewardStatus": "SIGNED_UNCLAIMED", "claimable": true, "orderNo": "", "walletCategory": 1 } ], "serverBizDate": "2026-08-20" }, "message": "success", "status_code": 6000 } ~~~ ## data 字段 | 字段 | 类型 | 说明 | |---|---|---| | activityId | int64 | 当前活动 ID | | enabled | boolean | 签到活动是否启用 | | checkedInToday | boolean | 今天是否已经签到 | | currentStreak | int | 当前连续签到天数 | | walletCategory | int | 连续奖励默认钱包类别 | | continuousRewards | array | 连续签到里程碑列表 | | serverBizDate | string | 服务端业务日期，格式 YYYY-MM-DD | | orderNo | string | 传入 orderNo 时返回的订单号 | ## continuousRewards[] 字段 | 字段 | 类型 | 说明 | |---|---|---| | enabled | boolean | 奖励节点是否启用 | | targetDays | int | 达标所需连续签到天数 | | currentDays | int | 当前已累计连续签到天数 | | rewardAmount | string | 节点奖励金额 | | status | string | LOCKED、PENDING、CLAIMABLE、CLAIMED、SIGNED_UNCLAIMED、PROCESSING；RewardStatus=SUCCESS 映射为 CLAIMED，FAILED 映射为 CLAIMABLE | | rewardStatus | string | 奖励订单状态：PENDING、PROCESSING、SUCCESS、FAILED、SIGNED_UNCLAIMED；不要与 status 当成同一枚举 | | claimable | boolean | 是否允许调用连续奖励领取接口 | | orderNo | string | 正常达到连续奖励节点时由签到或补签事务预先生成；仅历史或异常缺失数据时可能为空 | | walletCategory | int | 奖励钱包类别 | ## orderNo 筛选规则 - orderNo 为空：返回当前活动全部 continuousRewards 节点。 - rewardStatus=SIGNED_UNCLAIMED 且 walletCategory=2：必须使用合法 venueId 完成场馆奖励领取。 - orderNo 不为空：只返回匹配该订单的节点；订单不存在、不是连续奖励订单或不属于当前会员时返回错误。 - 该接口只查询连续奖励进度，不会创建订单，也不会发放奖励。 > **当前代码行为：** 新签到或补签达到连续奖励节点时，服务端会在同一事务中创建 CONTINUOUS 奖励记录和 orderNo，但不会自动发奖。因此正常新数据达到 CLAIMABLE 时应返回非空 orderNo，可直接用于 claimContinuousReward。只有迁移前历史数据、异常缺失记录或订单创建失败等非正常情况才可能出现空 orderNo；客户端遇到空值时停止领取并查询数据，不要自行构造订单号。 ## 推荐流程与异常处理 1. 调用 giftOverview 或本接口获取 currentStreak 和 continuousRewards。 2. 当 status=CLAIMABLE、claimable=true 且 orderNo 非空时，调用 claimContinuousReward。 3. 正常新数据达到节点时 orderNo 已由签到或补签事务创建；若异常为空，停止领取并排查历史或缺失数据。 4. 领取后再次调用本接口，确认节点状态变为 CLAIMED，并结合 rewardStatus 确认最终到账。 5. Token 无效、活动定位参数不足或 checkInType 不支持时，返回参数或登录错误。 6. status_code=6000 只表示查询处理成功，不代表连续奖励已经到账。 # 领取普通奖励 ## 接口用途领取当前会员指定业务日期的普通签到奖励。接口负责读取可领取记录、发送奖励并返回最新奖励状态；场馆钱包盲盒奖励不要使用本接口，应改用 claimBlindBox 并传入合法 venueId。 ## 请求 ~~~http POST /act/api/v1/dailyCheckIn/claimReward ~~~ 请求体： ~~~json { "activityId": 3510004, "bizDate": "2026-08-20" } ~~~ | 字段 | 类型 | 必填 | 说明 | |---|---|---:|---| | activityId | int64 | 新活动必填 | 活动 ID；未传 opActId 时作为活动定位字段 | | opActId | int64 | 兼容可选 | 旧字段名；服务端优先使用 opActId | | bizDate | string | 否 | 要领取的业务日期，格式 YYYY-MM-DD；为空时使用活动时区当天 | | venueId | string | 条件必填 | 仅在业务允许指定场馆时使用；盲盒场馆奖励应调用 claimBlindBox | 请求头：Content-Type: application/json、SSYY-Site-Id、SSYY-Client-Type、SSYY-Token。必须携带当前会员有效 Token。 ## 返回示例 ~~~json { "data": { "returnFlg": 0, "success": true, "alreadyCheckedIn": true, "bizDate": "2026-08-20", "vipLevelSnapshot": 0, "baseBonus": "1.00", "milestoneDays": null, "milestoneBonus": "0.00", "cumulativeDays": null, "cumulativeBonus": "0.00", "totalBonus": "1.00", "bonus": 1, "currentStreak": 1, "orderNo": "订单号", "checkInType": "FREE", "rewardStatus": "SUCCESS", "rewardType": 1, "blindBoxItemId": 0, "walletCategory": 1, "venueIds": "", "selectedVenueId": "", "flowTimes": 1, "isPatch": 0 }, "message": "success", "status_code": 6000 } ~~~ ## 领取前置条件 - 活动 ID 必须有效，且当前活动配置已启用。 - 会员必须存在对应日期的可领取奖励记录。 - 该记录不能已经成功领取；已成功领取时接口返回当前成功结果，不重复发放。 - 普通钱包奖励使用 claimReward；场馆钱包盲盒奖励必须使用 claimBlindBox。 - bizDate 为空时按活动时区计算当天日期，不建议客户端依赖本地日期。 - 奖励状态为 SIGNED_UNCLAIMED 时，先按 rewardType 和 walletCategory 完成对应领取步骤。 ## data 字段 | 字段 | 类型 | 说明 | |---|---|---| | success | boolean | 领取处理是否成功 | | bizDate | string | 实际领取业务日期 | | totalBonus | string | 本次领取的奖励总额 | | rewardStatus | string | PENDING、PROCESSING、SUCCESS、FAILED、SIGNED_UNCLAIMED | | rewardType | int | 1 普通奖励，2 盲盒奖励 | | walletCategory | int | 钱包类别；场馆钱包通常为 2 | | venueIds | string | 可用场馆 ID 列表 | | selectedVenueId | string | 已选择的场馆 ID | ### 当前源码实际返回补充 claimReward 控制器当前直接返回完整的 Result，除上表字段外，还可能包含以下字段。客户端应按需读取，并允许未使用字段存在： | 字段 | 类型 | 说明 | |---|---|---| | returnFlg | int | 业务处理标志 | | alreadyCheckedIn | boolean | 对应签到记录是否已存在 | | vipLevelSnapshot | int | 记录创建时的 VIP 快照 | | baseBonus | string | 基础奖励金额 | | milestoneDays / milestoneBonus | int 或 null / string | 连续签到节点及金额 | | cumulativeDays / cumulativeBonus | int 或 null / string | 累计签到节点及金额 | | currentStreak | int | 当前连续签到天数 | | orderNo | string | 奖励订单号，可用于 rewardStatus | | checkInType | string | 签到类型 | | flowTimes | int | 流水倍数 | | isPatch | int | 1 表示补签 | > claimBlindBox 成功时使用精简响应转换；claimReward 成功和失败时均可能返回完整 Result。 ## 处理流程与异常 1. 从 giftOverview、sign、patchSign 或 rewardStatus 获取活动 ID、bizDate 和奖励状态。 2. 普通钱包奖励调用本接口；不要重复提交同一日期。 3. 若 walletCategory=2，停止调用本接口，改用 claimBlindBox。 4. status_code=6000 只表示接口处理成功；必须同时检查 success 和 rewardStatus。 5. 发送奖励失败时通常返回 FAILED，并保留记录状态；客户端应查询 rewardStatus 后再决定是否重试。 # 领取场馆盲盒奖励 ## 接口用途领取签到盲盒奖励并将奖励发放到指定场馆钱包。只有 rewardType=2 的盲盒奖励可以使用本接口；普通钱包奖励使用 claimReward。 ## 请求 ~~~http POST /act/api/v1/dailyCheckIn/claimBlindBox ~~~ 请求体： ~~~json { "activityId": 3510004, "bizDate": "2026-08-20", "venueId": "1530029" } ~~~ | 字段 | 类型 | 必填 | 说明 | |---|---|---:|---| | activityId | int64 | 新活动必填 | 活动 ID；未传 opActId 时作为活动定位字段 | | opActId | int64 | 兼容可选 | 旧字段名；用于定位活动 | | bizDate | string | 否 | 要领取的业务日期，格式 YYYY-MM-DD；为空时使用活动时区当天 | | venueId | string | 条件必填 | 目标场馆 ID；必须来自 rewardStatus 或签到结果的合法 venueList | 请求头：Content-Type: application/json、SSYY-Site-Id、SSYY-Client-Type、SSYY-Token。必须携带当前会员有效 Token。 ## 返回示例 ~~~json { "data": { "success": true, "bizDate": "2026-08-20", "totalBonus": "3.00", "rewardStatus": "SUCCESS", "rewardType": 2, "walletCategory": 2, "venueIds": "1530029,1530030", "selectedVenueId": "1530029" }, "message": "success", "status_code": 6000 } ~~~ ## 使用条件 - 活动 ID 必须有效，且会员存在对应日期的待领取奖励记录。 - 目标记录必须是盲盒奖励（rewardType=2）；普通奖励调用本接口会失败。 - 当对外 rewardStatus=SIGNED_UNCLAIMED、rewardType=2 且 walletCategory=2 时，从 venueList 选择合法 venueId。 - venueId 必须属于服务端返回的可选场馆集合，不能由客户端任意拼接。 - 同一奖励成功领取后重复调用不会重复发放，返回已有成功结果。 - bizDate 为空时按活动时区确定日期，不要直接使用客户端本地日期。 ## 返回字段 | 字段 | 类型 | 说明 | |---|---|---| | success | boolean | 领取处理是否成功 | | bizDate | string | 实际领取业务日期 | | totalBonus | string | 盲盒奖励金额 | | rewardStatus | string | PROCESSING、SUCCESS、FAILED | | rewardType | int | 固定为 2，表示盲盒奖励 | | walletCategory | int | 场馆钱包类别，通常为 2 | | venueIds | string | 服务端允许的场馆 ID 列表 | | selectedVenueId | string | 本次选择的场馆 ID | ## 成功与失败 data 结构 - 成功时 data 固定为上表的精简结构。 - 服务调用失败且已取得奖励记录时，当前控制器会把完整 Result 放入失败响应的 data；参数、Token 等前置失败没有记录时 data 为空对象。 - 因此客户端失败分支只应依赖 status_code 和 message，不能假设 data 与成功结构一致。 ## 推荐调用流程 1. 调用 giftOverview、sign 或 patchSign 获取奖励记录。 2. 当奖励状态为 SIGNED_UNCLAIMED、rewardType=2 且 walletCategory=2 时，读取 venueList。 3. 选择 venueList 中合法的 venueId，调用本接口。 4. 返回后检查 success 和 rewardStatus；只有 SUCCESS 才确认奖励到账。 5. 如果返回 FAILED，先调用 rewardStatus 查询记录，再按业务策略重试。 ## 与 claimReward 的区别 - claimReward：领取普通钱包奖励。 - claimBlindBox：产品接入规则只用于盲盒场馆钱包奖励，必须校验 rewardType=2、walletCategory=2 和合法 venueId。 - 当前代码在未传 venueId 时仍可能尝试中心钱包领取；这是实现层面的宽松行为，不作为客户端调用依据。其他奖励统一调用 claimReward。 - 两个接口都要求有效 Token，并且都不应在同一奖励上重复提交。 # 领取连续签到奖励 ## 接口用途领取当前会员已经达到条件的连续签到里程碑奖励。普通签到只记录连续奖励进度，不会自动发放该里程碑；达到条件后必须调用本接口显式领取。 ## 请求 ~~~http POST /act/api/v1/dailyCheckIn/claimContinuousReward ~~~ 请求体： ~~~json { "activityId": 3510004, "orderNo": "ASG连续奖励订单号", "venueId": "" } ~~~ | 字段 | 类型 | 必填 | 说明 | |---|---|---:|---| | activityId | int64 | 条件必填 | 活动 ID；未传 opActId 时作为活动定位字段 | | opActId | int64 | 兼容可选 | 旧字段名；用于定位活动 | | orderNo | string | 是 | continuousRewardStatus 返回的连续奖励订单号；用于领取指定里程碑 | | venueId | string | 否 | 当前连续奖励通常发放中心钱包；如业务返回场馆选择要求，必须使用合法 venueId | 请求头：Content-Type: application/json、SSYY-Site-Id、SSYY-Client-Type、SSYY-Token。必须携带当前会员有效 Token。 ## 返回示例 ~~~json { "data": { "claimedCount": 1, "totalBonus": "5.00", "rewardStatus": "PROCESSING", "orderNos": ["连续奖励订单号"], "orderNo": "连续奖励订单号" }, "message": "success", "status_code": 6000 } ~~~ ## 返回字段 | 字段 | 类型 | 说明 | |---|---|---| | claimedCount | int | 本次实际创建或领取的连续奖励数量 | | totalBonus | string | 本次领取奖励总金额 | | rewardStatus | string | PROCESSING、FAILED 或 NONE；最终到账需继续查询订单 | | orderNos | array | 本次处理涉及的全部奖励订单号 | | orderNo | string，条件返回 | orderNos 恰好一笔时返回；其他情况字段省略 | ## 失败响应说明 - 常规失败 data 包含 claimedCount、totalBonus、rewardStatus=FAILED、orderNos。 - 部分数据库或发奖内部失败分支当前可能不返回 rewardStatus；客户端失败时以 status_code 和 message 为主。 - 没有业务 data 的前置校验失败会由统一包装转换为空对象。 ## 领取条件 - orderNo 不能为空，且必须对应当前会员的 CONTINUOUS 连续奖励订单。 - orderNo 不属于当前活动、不是连续奖励订单或订单不存在时，领取失败。 - 活动配置必须开启 continuousEnabled。 - 当前连续签到天数必须达到对应里程碑天数。 - 已经成功领取的里程碑不会重复发放；接口具备幂等保护。 - 领取失败或待处理订单可能被重试，客户端不要并发重复提交同一 orderNo。 ## 推荐调用流程 1. 调用 continuousRewardStatus 获取 continuousRewards。 2. 找到 status=CLAIMABLE 且 claimable=true 的节点，读取 orderNo。 3. 调用本接口提交 orderNo。 4. 返回 PROCESSING 时使用 rewardStatus 查询 orderNo，直到 SUCCESS 或 FAILED。 5. 返回 NONE 时表示当前没有可领取的连续奖励，不要继续重试。 6. 如果业务返回 venueId 要求，必须从服务端提供的合法场馆列表中选择，不要自行拼接。 ## 与其他领取接口的区别 - claimReward：领取普通签到奖励。 - claimBlindBox：领取盲盒场馆钱包奖励。 - claimContinuousReward：领取连续签到里程碑奖励；它不是普通每日签到奖励。