取随机数接口文档说明
✨ 取随机数接口规则:通过 min(最小值) 和 max(最大值) 定义取值范围,返回该范围内的随机整数;支持正数/负数范围,常用于抽奖、随机选择、模拟数据等场景。
接口地址:
https://api.qyuan.asia/api/sjs
请求方式:
GET(参数拼接便捷,支持POST兼容)
请求类型:
无特殊要求(浏览器/代码调用均可)
返回格式:
JSON(默认,含随机数结果与范围信息)
接口用途:
生成指定范围内的随机整数,适用于抽奖、随机排序、模拟测试数据等场景
Header 参数
<<<<<| 参数名称 |
<<<<<参数类型 |
<<<<<示例值 |
<<<<<参数说明 |
| 无 |
— |
— |
本接口无需 Header 参数,直接调用即可 |
请求参数(Query / Body)
<<<<<| 参数名称 |
<<<<<参数类型 |
<<<<<示例值 |
<<<<<参数说明 |
| min |
number(支持string类型数字) |
1 / -10 |
必填,随机数的最小值(可填正数或负数,需小于max值) |
| max |
number(支持string类型数字) |
100 / 5 |
必填,随机数的最大值(可填正数或负数,需大于min值) |
请求示例
// 1. 生成1-100的随机数(抽奖场景)
https://api.qyuan.asia/api/sjs?min=1&max=100
// 2. 生成-5到5的随机数(模拟正负值场景)
https://api.qyuan.asia/api/sjs?min=-5&max=5
// 3. POST请求示例(JSON格式)
POST https://api.qyuan.asia/api/sjs
Content-Type: application/json
{
"min": 10,
"max": 20
}
返回示例
// 1. 对应“1-100随机数”请求返回
{
"code": 200,
"msg": "生成成功",
"data": {
"min": 1, // 传入的最小值
"max": 100, // 传入的最大值
"randomNumber": 68 // 生成的随机数(每次返回不同)
}
}
// 2. 对应“-5到5随机数”请求返回
{
"code": 200,
"msg": "生成成功",
"data": {
"min": -5,
"max": 5,
"randomNumber": -2
}
}
// 3. 参数错误(min>max)返回
{
"code": 400,
"msg": "参数错误",
"data": "min值需小于max值"
}