A AuthMS API Wiki API Reference iam.tianv.com →

POST /admin/points/batch-earn

管理员操作,一次请求向多个用户发放积分。逐条处理,每条记录独立处理,某条失败不影响其他记录。

积分服务 `bearerAuth` application/json

Request Body

Schema: dto.BatchEarnRequest

FieldTypeRequiredExampleConstraintsDescription
users array of

See dto.BatchEarnUser

Yes
description string No
source string No

Responses

StatusDescriptionSchema
200批量发放完成,返回成功和失败的统计dto.BatchEarnResponse
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
403无权限gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.BatchEarnItem

FieldTypeRequiredExampleConstraintsDescription
amount integer No 100
error string No
new_balance integer No 1100
success boolean No True
user_id string No user-001

dto.BatchEarnResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.BatchEarnResult No
message string No
timestamp string No

dto.BatchEarnResult

FieldTypeRequiredExampleConstraintsDescription
failed_count integer No 1
results array of

See dto.BatchEarnItem

No
success_count integer No 3

dto.BatchEarnUser

FieldTypeRequiredExampleConstraintsDescription
amount integer Yes
user_id string Yes

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No