POST /points/{user_id}/transfer
将积分从当前用户账户转给同租户下另一用户。需要租户开启 TransferEnabled 配置。通过 X-Idempotency-Key 请求头防幂等重复转账。
积分服务 `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|
user_id |
path |
string |
Yes |
|
|
|
发送方用户ID |
X-Idempotency-Key |
header |
string |
No |
|
|
|
幂等键，推荐UUID |
Request Body
Schema: dto.TransferPointsRequest
| Field | Type | Required | Example | Constraints | Description |
|---|
amount |
integer |
Yes |
|
|
|
to_user_id |
string |
Yes |
|
|
|
description |
string |
No |
|
|
|
reason |
string |
No |
|
length: ?–200 |
|
source |
string |
No |
|
|
|
Referenced Schemas
dto.PointAccountResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
balance |
integer |
No |
1500 |
|
|
created_at |
string |
No |
2026-01-15T10:30:00Z |
|
|
exchange_rate |
integer |
No |
100 |
|
|
expired_points |
integer |
No |
100 |
|
|
frozen_balance |
integer |
No |
200 |
|
|
id |
string |
No |
01ARZ3NDEKTSV4RRFFQ69G5FAV |
|
|
points_type |
string |
No |
cash_equivalent |
|
|
status |
string |
No |
active |
|
|
tenant_id |
string |
No |
tnt_example_001 |
|
|
total_earned |
integer |
No |
5000 |
|
|
total_spent |
integer |
No |
3500 |
|
|
updated_at |
string |
No |
2026-04-10T14:20:00Z |
|
|
user_id |
string |
No |
usr_example_001 |
|
|
version |
integer |
No |
3 |
|
|
dto.PointOperationData
dto.PointOperationResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
data |
dto.PointOperationData |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
dto.PointTransactionResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
account_id |
string |
No |
01ARZ3NDEKTSV4RRFFQ69G5FAV |
|
|
amount |
integer |
No |
100 |
|
|
balance_after |
integer |
No |
1500 |
|
|
balance_before |
integer |
No |
1400 |
|
|
created_at |
string |
No |
2026-04-15T10:30:00Z |
|
|
description |
string |
No |
每日签到奖励 |
|
|
expires_at |
string |
No |
2027-01-15T10:30:00Z |
|
|
id |
string |
No |
01ARZ3NDEKTSV4RRFFQ69G5FAV |
|
|
idempotency_key |
string |
No |
ik_abc123 |
|
|
reason |
string |
No |
签到奖励 |
|
|
related_id |
string |
No |
01ARZ3NDEKTSV4RRFFQ69G5FAV |
|
|
source |
string |
No |
daily_checkin |
|
|
status |
string |
No |
completed |
|
|
type |
string |
No |
earn |
|
|
updated_at |
string |
No |
2026-04-15T10:30:00Z |
|
|
user_id |
string |
No |
usr_example_001 |
|
|
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|