/admin/points/batch-earn
管理员操作,一次请求向多个用户发放积分。逐条处理,每条记录独立处理,某条失败不影响其他记录。
请求体
Schema: service-point/internal/handler/dto.BatchEarnRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
users |
array of |
是 | |||
description |
string |
否 | |||
source |
string |
否 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 批量发放完成,返回成功和失败的统计 | service-point/internal/handler/dto.BatchEarnResponse |
| 400 | 请求参数错误 | service-core/base/dto.SimpleResponse |
| 401 | 未认证 | service-core/base/dto.SimpleResponse |
| 403 | 无权限 | service-core/base/dto.SimpleResponse |
| 500 | 服务器内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-point/internal/handler/dto.BatchEarnItem
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
amount |
integer |
否 | 100 |
||
error |
string |
否 | |||
new_balance |
integer |
否 | 1100 |
||
success |
boolean |
否 | True |
||
user_id |
string |
否 | user-001 |
service-point/internal/handler/dto.BatchEarnResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-point/internal/handler/dto.BatchEarnResult |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-point/internal/handler/dto.BatchEarnResult
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
failed_count |
integer |
否 | 1 |
||
results |
array of |
否 | |||
success_count |
integer |
否 | 3 |
service-point/internal/handler/dto.BatchEarnUser
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
amount |
integer |
是 | |||
user_id |
string |
是 |