积分活动接口与任务奖励接入

适用版本：会员插件 1.3.3 · 核对日期：2026-10-10

用途

区分由会员规则计算的活动积分与由调用插件已经确定金额的任务奖励。

前置条件

可信调用方完成统一令牌配置；目标会员存在。活动路径需发布 CONTENT_LIKED 规则；任务路径由调用方确定应发金额和审核依据。

操作入口

活动：POST /apis/public.member.muyin.site/v1alpha1/integration/point-activities。确定金额的奖励使用统一交易接口。

操作步骤

活动接口当前只允许 CONTENT_LIKED；由可信插件确定奖励对象和业务关系。
为同一点赞关系生成稳定请求 ID，首次发布 active: true。
取消该关系时使用相同 ID、用户和活动类型发送 active: false，由原规则快照决定撤回或保留。
保存返回的来源键和事件，查询后台事件与流水最终结果。
任务审核奖励已知具体金额时，按统一交易提交 SCORE_TASK_REWARD 或相应余额奖励，保留任务/提交 ID。

预期结果与核对

活动被接收后进入积分事件处理；任务交易走账户变更与流水路径。两类结果均需按实际账户完成状态核对。

限制与注意事项

活动接口 accepted 和 eventCount 不代表已经加分；没有有效规则时可能没有事件。活动 ID 最多 128 位，只含字母、数字、点、下划线、冒号和连字符。活动时间允许最近 31 天且不能超前超过 5 分钟；属性最多 20 项。旧任务专用路径保留兼容，不作为新调用方的首选扩展方式。

常见问题

可以提交 COMMENT_APPROVED 吗？ 当前外部活动入口不接受，评论/回复由 Halo 协调器产生。
取消后再点赞能否用新 ID 领奖？ 同一关系必须复用 ID，调用方不得通过换 ID 规避一次来源一次事件的约束。
规则没发奖是否改用任务接口补发？ 先检查事件原因，确认业务授权与原结果后再决定补偿，不能绕过限额。

获赞活动示例

{
  "requestId": "like-relation-001",
  "userId": "alice",
  "activityType": "CONTENT_LIKED",
  "active": true,
  "attributes": {"postName": "post-example"}
}

携带 X-Muyin-Member-Token；省略 occurredAt 使用接收时间。撤销时保持业务字段不变，仅将 active 改为 false。用户标识由可信调用方核验，不直接信任匿名浏览器提交的奖励对象。