Users

Authenticate or Create User

• Endpoint: POST /v1/user/auth

• Description: Authenticates a user or creates them if they do not exist.

• Headers:

  • Authorization: Bearer <accessToken>
  • x-signed-request: <signature>

• Body:

  Field	Type	Required	Description
  profileId	string	Yes	Profile ID
  credential	string	Yes	User identifier
  credentialType	string	Yes	email, uuid, or username

• Success Response (200):

{
  "status": "success",
  "data": {
    "userToken": "user_token_value",
    "userId": "507f1f77bcf86cd799439022"
  }
}

• Errors: 400, 401, 403, 500

List Users

• Endpoint: GET /v1/user

• Description: Lists users for the API client.

• Headers: Authorization: Bearer <accessToken>

• Query Params:

  Field	Type	Required	Description
  dateStart	string	No	YYYY-MM-DD
  dateEnd	string	No	YYYY-MM-DD
  pageIndex	number	No	Default 1
  pageSize	number	No	Default 20
  userId	string	No	Filter by user

• Success Response (200):

{
  "status": "success",
  "data": [
    {
      "id": "507f1f77bcf86cd799439022",
      "credential": "player@example.com",
      "credentialType": "email",
      "balance": 1250.5,
      "profileId": "507f1f77bcf86cd799439011",
      "createdAt": "2025-01-02T11:00:00.000Z"
    }
  ],
  "pagination": {
    "pageIndex": 1,
    "pageSize": 20,
    "totalCount": 1,
    "totalPages": 1
  }
}

• Errors: 400, 401, 500