← API.MAO.MS 首页EN

随机数 API

免费、无需密钥。适合抽奖摇号、验证码与随机口令生成、测试数据、UUID 分配等场景。

随机源说明

本站随机数由服务器操作系统熵池(getrandom)驱动:宿主机的硬件随机源与系统熵持续汇入内核的加密级随机数发生器(ChaCha20),接口全程不使用任何可预测的伪随机算法(如 PHP 的 rand / mt_rand、JS 的 Math.random)。每次调用独立取数,响应禁止缓存——你每次拿到的都是新随机数。

接口文档

基础路径 /v1/random,全部为 GET 请求,返回 {code, message, data}。

GET /v1/random/int 随机整数

参数默认说明
min1最小值(含)
max100最大值(含)
count1生成个数,1–1000
请求:/v1/random/int?min=1&max=100&count=3
返回:{"code":0,"message":"ok","data":{"min":1,"max":100,"count":3,"numbers":[8,66,78]}}

GET /v1/random/string 随机字符串

参数默认说明
length16长度,1–1024
typealnum预设字符集:digits 纯数字 / lower 小写 / upper 大写 / alnum 数字+大小写 / symbols alnum+符号
charset—自定义字符集:传入后优先于 type,从你给的字符里随机抽取(支持中文等 Unicode 字符,自动去重,最多 256 个,不含空白与控制字符)
请求:/v1/random/string?length=16&type=alnum
返回:{"code":0,"message":"ok","data":{"length":16,"type":"alnum","string":"RYNbBOJV5xSmGy4Z"}}

请求:/v1/random/string?length=8&charset=春夏秋冬
返回:{"code":0,"message":"ok","data":{"length":8,"type":"custom","charset_size":4,"string":"冬春夏秋冬夏春冬"}}

GET /v1/random/uuid UUID v4

参数默认说明
count1生成个数,1–100
请求:/v1/random/uuid
返回:{"code":0,"message":"ok","data":{"count":1,"uuids":["afee4e2c-16f8-4b71-a8d0-31187758fb2d"]}}

GET /v1/random/float 随机浮点数

参数默认说明
min0最小值(含)
max1最大值(不含)
precision6小数位数,0–15
请求:/v1/random/float?min=0&max=1&precision=6
返回:{"code":0,"message":"ok","data":{"min":0,"max":1,"value":0.045965}}

GET /v1/random/shuffle 不重复抽取

从区间内洗牌后抽取,保证不重复,适合摇号、抽奖。

参数默认说明
min1最小值(含)
max49最大值(含)
count5抽取个数,不得超过区间大小
请求:/v1/random/shuffle?min=1&max=49&count=5
返回:{"code":0,"message":"ok","data":{"min":1,"max":49,"count":5,"numbers":[23,31,20,29,19]}}

调用统计

随机数接口累计被调用 13 次 · 今日 13 次。全部接口统计见 调用统计页。

接口路径今日累计
随机整数/v1/random/int44
随机字符串/v1/random/string22
UUID/v1/random/uuid33
随机浮点数/v1/random/float22
不重复抽取/v1/random/shuffle22
接口索引/v1/random00

在线测试

点上面的按钮,这里会显示接口的真实返回。