Weighted Random Item Selector

Choose this endpoint when you need non-uniform random selection where different options should have different probabilities of being chosen. Prefer it over a simple shuffle or uniform random pick when outcomes have known likelihoods, rarity tiers, or priority scores. It is ideal for loot tables, A/B test traffic splitting, raffle draws, probabilistic routing, and simulation tasks where outcome frequency must match specified weights.

• Array exceeds 1000 items — returns 400 error
• Weight values are zero or negative — invalid input
• Items array is empty — returns error with no selection
• Malformed item objects missing required value or weight fields — validation error
• Payment not provided or insufficient — returns 402 Payment Required