Autional Autional
API Reference GitHub autional.com →

POST /admin/points

Create a points account for the user under the current tenant. A user can only have one points account under the same tenant.

Points Service `bearerAuth` application/json

Request Body

Schema: dto.CreatePointAccountRequest

FieldTypeRequiredExampleConstraintsDescription
user_id string Yes

Responses

StatusDescriptionSchema
201Points account created successfullydto.PointAccountDetailResponse
400Bad requestgitee_com_linmes_authms_base_dto.SimpleResponse
401Unauthorizedgitee_com_linmes_authms_base_dto.SimpleResponse
403Forbiddengitee_com_linmes_authms_base_dto.SimpleResponse
404Resource not foundgitee_com_linmes_authms_base_dto.SimpleResponse
409Account already existsgitee_com_linmes_authms_base_dto.SimpleResponse
500Internal server errorgitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.PointAccountDetailResponse

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

dto.PointAccountResponse

FieldTypeRequiredExampleConstraintsDescription
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

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No