Endpoint URL:
https://aisenseapi.com/services/v1/random_number

Description:
This endpoint generates a random integer within a specified range. The range is determined by two optional parameters, from and to, provided as part of the request URL. If no parameters are provided, the default range is from 1 to 6. If the to value is less than the from value, the endpoint automatically swaps them to ensure a valid range.

Response Format:

• Content-Type: application/json

• Example Success Response: json

  {
 "random_number": 4,
 "range": {
  "from": 1,
  "to": 6
 }
}


• Example Error Response: json

  {
 "error": "The values for $from and $to are out of range."
}


Input Requirements:

• Optional URL Parameters:
  • from: The starting number of the range (default: 1).
  • to: The ending number of the range (default: 6).
  • Both parameters must be integers within PHP’s integer range.

Examples:

1. Generate a random number between 1 and 6 (default behavior):

   https://aisenseapi.com/services/v1/random_number


   Response: json

   {
"random_number": 4,
 "range": {
  "from": 1,
  "to": 6
 }
}

2. Generate a random number between 10 and 20:

   https://aisenseapi.com/services/v1/random_number/10/20


   Response: json

   {
 "random_number": 15,
 "range": {
  "from": 10,
  "to": 20
 }
}

3. Handle swapped range values (e.g., to less than from):

   https://aisenseapi.com/services/v1/random_number/20/10


   Response: json

   {
 "random_number": 17,
 "range": {
  "from": 10,
  "to": 20
 }
}

4. Handle minus range values:
   https://aisenseapi.com/services/v1/random_number/-57/-3
   Response: json
   {
    “random_number”: –17,
    “range”: {
     “from”: -57,
     “to”: -3
    }
   }
   

5. Handle only one range value (second undefined value is default: 1)
   https://aisenseapi.com/services/v1/random_number/30
   Response: json
   {
    “random_number”: 16,
    “range”: {
     “from”: 1,
     “to”: 30
    }
   }

Use Cases:

• Generating random numbers for applications, games, or simulations.
• Providing random values for testing or sampling.
• Using in systems that require dynamic, random inputs.

How to Use:

1. Send a GET request to the endpoint URL.
2. Optionally include two integers (from and to) as part of the URL.
3. The response will return a random number within the specified range and confirm the range used.