任务系统 Flutter 对接

获取任务页

地址：GET /api/v1/tasks/tabs

参数：无。需要登录态。

返回值：

{
  "sections": [
    {
      "section": "daily",
      "server_time_ms": 1781097600000,
      "next_refresh_at_ms": 1781136000000,
      "items": [
        {
          "task_id": "task_xxx",
          "task_type": "daily",
          "category": "gift",
          "audience_type": "all",
          "metric_type": "gift_spend_coin",
          "title": "普通礼物消耗金币",
          "description": "",
          "icon_key": "gift",
          "icon_url": "",
          "action_type": "gift_panel",
          "action_param": "",
          "action_payload": {},
          "action_payload_json": "{}",
          "dimension_filter_json": "{}",
          "target_value": 10000,
          "target_unit": "coin",
          "progress_value": 1200,
          "reward_coin_amount": 200,
          "status": "in_progress",
          "claimable": false,
          "task_day": "2026-06-11",
          "server_time_ms": 1781097600000,
          "next_refresh_at_ms": 1781136000000,
          "sort_order": 10,
          "version": 1
        }
      ]
    },
    {
      "section": "exclusive",
      "server_time_ms": 1781097600000,
      "next_refresh_at_ms": 1781136000000,
      "items": []
    }
  ],
  "server_time_ms": 1781097600000,
  "next_refresh_at_ms": 1781136000000
}

说明：

section=daily 是每日任务，按服务端 UTC 00:00 刷新。
section=exclusive 是专属/新手任务，task_day 固定为 lifetime。
claimable=true 显示领取按钮。
status=claimed 显示已领取。
其他状态显示去完成按钮，按 action_type 跳转。

领取任务奖励

地址：POST /api/v1/tasks/claim

参数：

{
  "task_id": "task_xxx",
  "task_type": "daily",
  "task_day": "2026-06-11",
  "command_id": "app-generated-uuid"
}

返回值：

{
  "claim_id": "tclaim_xxx",
  "task_id": "task_xxx",
  "task_type": "daily",
  "task_day": "2026-06-11",
  "reward_coin_amount": 200,
  "status": "granted",
  "wallet_transaction_id": "wtx_xxx",
  "granted_at_ms": 1781097600000,
  "claimed": true
}

说明：

command_id 由 App 每次点击领取时生成；同一次重试继续使用同一个 command_id。
每日任务只能领取当天 task_day。
专属任务领取时传列表里的 task_day，通常是 lifetime。

跳转类型

action_type	action_param
`none`	不跳转
`room_random`	随机进入一个有人的房间；没有有人的房间时进入随机房间
`room_random_game`	`game_id`，进入房间后打开指定游戏
`wallet`	打开钱包
`gift_panel`	进入房间后打开礼物面板
`gift_panel_specific`	`gift_id`，进入房间后打开礼物面板并定位指定礼物

2.9 KiB Raw Permalink Blame History

任务系统 Flutter 对接

获取任务页

领取任务奖励

跳转类型

相关 IM

2.9 KiB

Raw Permalink Blame History