> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cog888.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 取得玩家限紅

> 取得玩家限紅設定

<Accordion title="此 API 可能返回的錯誤代碼">
  | 代碼   | 說明            |
  | ---- | ------------- |
  | 0    | 成功            |
  | 2    | 無效參數          |
  | 4    | 客戶不存在         |
  | 19   | 請求次數已達上限      |
  | 20   | Secret key 錯誤 |
  | 21   | 非法用戶名稱        |
  | 36   | 伺服器錯誤         |
  | 42   | 請求頻率太高        |
  | 9999 | 未知錯誤          |
</Accordion>


## OpenAPI

````yaml /seamless-openapi.json GET /api/v1/dt/user/limit
openapi: 3.1.0
info:
  title: 單一錢包 API
  description: 單一錢包（Seamless Wallet）API 文檔，包含 Game-API 和 Wallet-API
  version: 1.0.0
servers:
  - url: https://api.example.com
    description: API Server
security: []
tags:
  - name: Game-API User
    description: 遊戲 API - 用戶相關操作
  - name: Game-API Report
    description: 遊戲 API - 報表查詢
  - name: Game-API Internal
    description: 遊戲 API - 內部專用（隱藏）
  - name: Wallet-API
    description: 錢包 API - 由 vendor 實作
paths:
  /api/v1/dt/user/limit:
    get:
      tags:
        - Game-API User
      summary: 取得玩家限紅
      description: 取得玩家限紅設定
      operationId: getPlayerLimit
      parameters:
        - name: uuid
          in: query
          required: true
          schema:
            type: string
          description: 各平台自定義的唯一性請求序號，長度 >= 32 且 <= 128 字節
        - name: platform_id
          in: query
          required: true
          schema:
            type: string
          description: 平台方的產品 ID
        - name: username
          in: query
          required: false
          schema:
            type: string
          description: 用戶在遊戲中的帳號（選填）。若未帶此參數，將返回該 platform_id 下所有可用的限紅組合（即掛帳代理帳號身上的限紅組合）
        - name: key
          in: query
          required: true
          schema:
            type: string
          description: md5(username + 平台密鑰)
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    $ref: '#/components/schemas/ErrorInfo'
                  data:
                    type: object
                    properties:
                      product-id:
                        type: string
                        description: 渠道代碼
                      currency:
                        type: string
                        description: 幣別
                      limit-set:
                        type: array
                        items:
                          type: string
                        description: 限紅設定清單
                      limit-detail:
                        type: array
                        items:
                          type: object
                          properties:
                            limit-id:
                              type: string
                              description: 限紅 ID
                            detail:
                              type: array
                              items:
                                type: object
                                properties:
                                  game-type:
                                    type: string
                                    description: 遊戲類型
                                  limit:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        play-type:
                                          type: array
                                          items:
                                            type: integer
                                          description: 玩法類型列表
                                        min:
                                          type: integer
                                          description: 最小限紅
                                        max:
                                          type: integer
                                          description: 最大限紅
              example:
                error:
                  code: 0
                  msg: Success
                  uuid: c176c773-f0f5-41f3-8f2e-9c0938d50a75
                data:
                  product-id: AXTES
                  currency: TWD
                  limit-set:
                    - '0'
                    - 'Y'
                  limit-detail:
                    - limit-id: '0'
                      detail:
                        - game-type: BAC
                          limit:
                            - play-type:
                                - 1
                                - 2
                              min: 100
                              max: 100000
                            - play-type:
                                - 3
                              min: 100
                              max: 12500
                            - play-type:
                                - 4
                                - 5
                              min: 100
                              max: 9000
                            - play-type:
                                - 6
                              min: 100
                              max: 8000
                        - game-type: DTB
                          limit:
                            - play-type:
                                - 1
                                - 2
                                - 4
                                - 5
                                - 6
                                - 7
                                - 8
                                - 9
                                - 10
                                - 11
                              min: 1000
                              max: 100000
                            - play-type:
                                - 3
                              min: 100
                              max: 12500
                        - game-type: NIU
                          limit:
                            - play-type:
                                - 1
                                - 2
                              min: 1000
                              max: 100000
                            - play-type:
                                - 3
                                - 4
                              min: 100
                              max: 20000
                            - play-type:
                                - 5
                                - 6
                              min: 100
                              max: 2000
                        - game-type: ROU
                          limit:
                            - play-type:
                                - 1
                              min: 1000
                              max: 100000
                            - play-type:
                                - 2
                              min: 1000
                              max: 50000
                            - play-type:
                                - 3
                              min: 100
                              max: 20000
                            - play-type:
                                - 4
                              min: 100
                              max: 12500
                            - play-type:
                                - 5
                              min: 100
                              max: 9000
                            - play-type:
                                - 6
                              min: 100
                              max: 5500
                            - play-type:
                                - 7
                              min: 100
                              max: 2500
                            - play-type:
                                - 8
                              min: 100
                              max: 16500
                    - limit-id: 'Y'
                      detail:
                        - game-type: BAC
                          limit:
                            - play-type:
                                - 1
                                - 2
                              min: 10000
                              max: 500000
                            - play-type:
                                - 3
                              min: 100
                              max: 62500
                            - play-type:
                                - 4
                                - 5
                              min: 100
                              max: 45000
                            - play-type:
                                - 6
                              min: 100
                              max: 41500
                        - game-type: DTB
                          limit:
                            - play-type:
                                - 1
                                - 2
                                - 4
                                - 5
                                - 6
                                - 7
                                - 8
                                - 9
                                - 10
                                - 11
                              min: 10000
                              max: 500000
                            - play-type:
                                - 3
                              min: 100
                              max: 62500
                        - game-type: NIU
                          limit:
                            - play-type:
                                - 1
                                - 2
                              min: 10000
                              max: 500000
                            - play-type:
                                - 3
                                - 4
                              min: 100
                              max: 100000
                            - play-type:
                                - 5
                                - 6
                              min: 100
                              max: 10000
                        - game-type: ROU
                          limit:
                            - play-type:
                                - 1
                              min: 10000
                              max: 500000
                            - play-type:
                                - 2
                              min: 10000
                              max: 250000
                            - play-type:
                                - 3
                              min: 100
                              max: 100000
                            - play-type:
                                - 4
                              min: 100
                              max: 62500
                            - play-type:
                                - 5
                              min: 100
                              max: 45000
                            - play-type:
                                - 6
                              min: 100
                              max: 29000
                            - play-type:
                                - 7
                              min: 100
                              max: 14000
                            - play-type:
                                - 8
                              min: 100
                              max: 83000
        '400':
          description: 請求錯誤
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 2
                  msg: >-
                    request hash signature(0FACF22B9E3DB5CDC670A0F7A65BB76A) is
                    error
                  uuid: 9e96610f-5388-42df-b3ed-ba1b3178c63b
components:
  schemas:
    ErrorInfo:
      type: object
      properties:
        code:
          type: integer
          description: 錯誤碼
        msg:
          type: string
          description: 錯誤訊息
        uuid:
          type: string
          description: 請求序號
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
          description: 錯誤代碼
        message:
          type: string
          description: 錯誤訊息
        data:
          description: 資料（通常為 null）
        status_code:
          type: integer
          description: HTTP 狀態碼
        service:
          type: string
          description: 服務名稱

````