Skip to main content

Spin Lucky Wheel (v1)

Method & Path​

POST /api/v1/public/dollab/spin

Actual path: /v1/public/dollab/spin

Description​

Picks a winning slice on the server using each item's appearance weight, then returns the winner id. The public /dollab page uses this so every visitor shares the same wheel and probabilities stay off the UI.

Authentication​

None. Persona: Customer (anyone with the link).

Headers​

  • Content-Type: application/json (optional; body is empty)

Request Body​

None.

Response 200 OK​

{
  "winnerId": "3f1a0c2e-4b8d-4a91-9c77-1d2e3f4a5b6c"
}

Common Errors​

  • 400 Bad Request: The wheel has no items
  • 500 Internal Server Error: Could not pick a winner