# 取得會員點數

## Get client points

> Retrieve the total available points for multiple clients.\
> \
> Conditional validation rules:\
> \- Can provide 'clientIds' for encoded client IDs\
> \- Can provide both 'platform' and 'platformClientIds' for platform-specific client lookup\
> \- At least one of clientIds or (platform + platformClientIds) must be provided<br>

```json
{"openapi":"3.0.3","info":{"title":"Manta OpenAPI","version":"0.318.0"},"tags":[{"name":"Client Points & Gifts","description":"Client points and gifts management"}],"servers":[{"url":"https://mantago.cc/api","description":"MantaGo Openapi host url"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token for API authentication"}},"schemas":{"ClientPointsRequest":{"type":"object","properties":{"secret":{"type":"string","description":"Secret key for API authentication"},"clientIds":{"type":"array","items":{"type":"string"},"maxItems":100,"description":"Array of encoded client IDs (maximum 100 items)"},"platform":{"type":"string","enum":["line","facebook","instagram","liveChat","whatsapp"],"description":"Platform type (required if platformClientIds provided)"},"platformClientIds":{"type":"array","items":{"type":"string"},"maxItems":100,"description":"Array of platform-specific client IDs (maximum 100 items, required if platform provided)"}},"required":["secret"],"description":"Client identification rules:\n- Can provide 'clientIds' for encoded client IDs\n- Can provide both 'platform' and 'platformClientIds' for platform-specific client lookup\n- At least one of clientIds or (platform + platformClientIds) must be provided\n"},"ClientPointsResponse":{"allOf":[{"$ref":"#/components/schemas/BasicSuccessResponse"},{"type":"object","properties":{"points":{"type":"array","items":{"$ref":"#/components/schemas/ClientPointInfo"},"description":"Array of client points information"}}}]},"BasicSuccessResponse":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]},"ClientPointInfo":{"type":"object","properties":{"platform":{"type":"string","enum":["line","facebook","instagram","liveChat","whatsapp"],"description":"Platform type"},"clientId":{"type":"string","description":"Encoded client ID (present when queried by clientIds)"},"platformClientId":{"type":"string","description":"Platform-specific client ID (present when queried by platformClientIds)"},"points":{"type":"integer","description":"Total available client points"}},"required":["platform","points"]},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errResponse":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"},"botId":{"type":"string"}},"required":["message","code"]}},"required":["success","errResponse"]}},"responses":{"TokenError":{"description":"JWT token is invalid or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"PermissionError":{"description":"Permission denied - insufficient access rights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"RateLimitError":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/openapi/client/point":{"post":{"tags":["Client Points & Gifts"],"summary":"Get client points","description":"Retrieve the total available points for multiple clients.\n\nConditional validation rules:\n- Can provide 'clientIds' for encoded client IDs\n- Can provide both 'platform' and 'platformClientIds' for platform-specific client lookup\n- At least one of clientIds or (platform + platformClientIds) must be provided\n","parameters":[{"name":"botId","in":"query","required":true,"schema":{"type":"string"},"description":"The bot ID for the API request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientPointsRequest"}}}},"responses":{"200":{"description":"Client points retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientPointsResponse"}}}},"401":{"$ref":"#/components/responses/TokenError"},"403":{"$ref":"#/components/responses/PermissionError"},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/RateLimitError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```