#服务投注限额 REST API 参考

本文档描述了用于管理投注限额逻辑的微服务。

版本：0.0.0
基础URL：{{API_BASE_URL}}/api/bet-limit
方案：HTTPS

#端点

自动分配玩家限制
为用户分配玩家限制
取消分配给用户的玩家限制

#1. 自动分配玩家限制

总结：当用户进入游戏并且没有分配任何玩家限制时，自动为用户分配玩家限制。
需要配置：商户必须联系PetaX来配置用于自动分配的玩家限制ID列表。
API 可用性：没有公共 API 可用于配置自动分配玩家限制。
触发：用户进入游戏。
条件：用户的玩家限制列表为空。
行为：

如果用户已经分配了一个或多个玩家限制，系统将不会自动分配任何额外的限制。
如果用户的玩家限制列表为空，系统将为商户分配PetaX配置的玩家限制ID。
配置的玩家限制ID必须存在于PetaX中才能用于自动分配。
此功能仅适用于配置启用后进入游戏的用户。

设置过程：

商户向PetaX提供玩家限制ID列表以启用自动分配。 -PetaX为商户配置自动分配玩家限制。
启用配置后，当符合条件的用户进入游戏时，将应用自动分配。

#2. 为用户分配玩家限制

端点：POST /a/player-limits/assign
摘要：为用户分配玩家限制。
权限：betLimit.playerLimits.assignUser
消耗：application/json
产生：application/json
安全：BearerAuth（授权：承载abcde12345）
注释：

通过用户 ID 或指定的用户名将多个玩家限制分配给多个用户。
错误代码 24004：为用户分配玩家限制，但未找到限制。
错误代码 24005：列表玩家限制已将项目分配给用户。

#请求

CURL：

curl -X POST "{{API_BASE_URL}}/api/bet-limit/a/player-limits/assign" \
  -H "Authorization: Bearer abcde12345" \
  -H "Content-Type: application/json" \
  -d '{
    "limitIds": [1, 2],
    "userIds": ["user-uuid-123", "user-uuid-124"],
    "username": "testuser"
  }'

参数：

Body：数据（必填）
类型：对象
Schema：

{
  limitIds: number[]; // Required, minItems: 1, maxItems: 50
  userIds?: string[]; // Optional, minItems: 1, maxItems: 50
  username?: string; // Required if userIds is empty
}

示例：

{
  "limitIds": [1, 2],
  "userIds": ["user-uuid-123", "user-uuid-124"],
  "username": "testuser"
}

#回应

200 好
描述：空
类型：字符串
示例：
```
""
```
有关错误状态（4xx、5xx），请参阅 API-错误处理

#3. 取消为用户分配玩家限制

端点：POST /a/player-limits/unassign
摘要：取消分配给用户的玩家限制。
权限：betLimit.playerLimits.assignUser
消耗：application/json
产生：application/json
安全：BearerAuth（授权：承载abcde12345）
注意：如果要删除用户的所有限制，请将 limitIds 设置为空。

#请求

CURL：

curl -X POST "{{API_BASE_URL}}/api/bet-limit/a/player-limits/unassign" \
  -H "Authorization: Bearer abcde12345" \
  -H "Content-Type: application/json" \
  -d '{
    "limitIds": [1, 2],
    "userIds": ["user-uuid-123", "user-uuid-124"],
    "username": "testuser"
  }'

参数：

Body：数据（必填）
类型：对象
Schema：

{
  limitIds?: number[]; // Optional, minItems: 1, maxItems: 50
  userIds?: string[]; // Optional, minItems: 1, maxItems: 50
  username?: string; // Required if userIds is empty
}

示例：

{
  "limitIds": [1, 2],
  "userIds": ["user-uuid-123", "user-uuid-124"],
  "username": "testuser"
}

#回应

200 好
描述：空
类型：字符串
示例：
```
""
```
有关错误状态（4xx、5xx），请参阅 API-错误处理