Getting Started

Our API provides simple HTTP endpoints for generating random numbers, rolling dice, and flipping coins. To get started, you'll need an API key.

curl -X GET "https://api.randomgenerator.com/v1/number?min=1&max=100" \
-H "Authorization: Bearer YOUR_API_KEY"

Endpoints

Generate Random Number

GET /v1/number

Parameters:

  • min (required): Minimum value
  • max (required): Maximum value

Roll Dice

GET /v1/dice

Parameters:

  • sides (optional): Number of sides (default: 6)
  • count (optional): Number of dice to roll (default: 1)

Flip Coin

GET /v1/coin

No parameters required