QyuanAPI
api.qyuan.asia

取随机数接口文档说明

✨ 取随机数接口规则:通过 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值" }
返回API首页 测试1-100随机数