随机数生成器 - 澄曜API Hub

基本信息

接口调用前需要确认的核心配置。

接口地址/api/random

请求方式GET

返回格式JSON

调用权限免费

ApiKey不需要

创建时间2026-04-27

脚本路由random

📊 当前您的权限信息

会员等级

免费用户

调用频率限制

100 次/分钟

可访问API类型

仅免费API

💡 注册成为普通会员可免审核即时获得 Key，调用频率提升至 180 次/分钟。升级VIP 可解锁全部API，调用频率提升至 300 次/分钟。

请求参数说明

必填参数必须传入，示例值可直接用于联调。

💡 统计个人调用次数

免费API不强制要求API Key，但如果您希望统计个人调用次数，请在请求时附加参数 key=您的API_KEY。注册账号后即可获得API Key。

参数名	必填	类型	说明	示例值
`key`	否	string	可选参数：携带此参数可统计您的个人调用次数。请注册账号获取API Key。	`YOUR_API_KEY`
`action`	否	string	操作类型：string=随机字符串 number=随机数字 bytes=随机字节 uuid=UUIDv4 password=密码 pick=随机选择 shuffle=随机洗牌 dice=骰子 lottery=彩票 color=随机颜色	`string`
`length`	否	number	长度(string/bytes/password时使用)，默认32/32/16	`16`
`min`	否	number	最小值(number时使用)，默认0	`1`
`max`	否	number	最大值(number时使用)，默认100	`100`
`count`	否	number	数量(number/pick/dice/lottery/color时使用)	`1`
`charset`	否	string	自定义字符集(string时使用)	`ABC123`
`uppercase`	否	string	含大写字母(string/password时)，默认true	`true`
`lowercase`	否	string	含小写字母(string/password时)，默认true	`true`
`numbers`	否	string	含数字(string/password时)，默认true	`true`
`symbols`	否	string	含符号(string/password时)，默认false	`false`
`avoid_ambiguous`	否	string	避免易混淆字符(password时)，默认false	`false`
`unique`	否	string	不重复选择(pick时)，默认true	`true`
`list`	否	string	候选项列表，逗号分隔(pick/shuffle时)	`苹果,香蕉,橘子`
`sides`	否	number	骰子面数(dice时)，默认6	`6`
`type`	否	string	彩票类型(lottery时)：ssq=双色球 dlt=大乐透 fc3d=福彩3D pl5=排列五 euro=EuroMillions powerball=Powerball mega=Mega Millions	`ssq`
`format`	否	string	输出格式(color时)：hex/rgb/detail，默认hex	`hex`
`encoding`	否	string	编码方式(bytes时)：hex/base64，默认hex	`hex`

示例代码

优先使用示例地址测试请求参数是否正确。

示例请求

https://api.ruseo.cn/api/random?action=string&length=16&min=1&max=100&count=1&charset=ABC123&uppercase=true&lowercase=true&numbers=true&symbols=false&avoid_ambiguous=false&unique=true&list=%E8%8B%B9%E6%9E%9C%2C%E9%A6%99%E8%95%89%2C%E6%A9%98%E5%AD%90&sides=6&type=ssq&format=hex&encoding=hex

cURL

curl "https://api.ruseo.cn/api/random?action=string&length=16&min=1&max=100&count=1&charset=ABC123&uppercase=true&lowercase=true&numbers=true&symbols=false&avoid_ambiguous=false&unique=true&list=%E8%8B%B9%E6%9E%9C%2C%E9%A6%99%E8%95%89%2C%E6%A9%98%E5%AD%90&sides=6&type=ssq&format=hex&encoding=hex"

PHP

$url = 'https://api.ruseo.cn/api/random?action=string&length=16&min=1&max=100&count=1&charset=ABC123&uppercase=true&lowercase=true&numbers=true&symbols=false&avoid_ambiguous=false&unique=true&list=%E8%8B%B9%E6%9E%9C%2C%E9%A6%99%E8%95%89%2C%E6%A9%98%E5%AD%90&sides=6&type=ssq&format=hex&encoding=hex';
$response = file_get_contents($url);
$data = json_decode($response, true);

JavaScript

fetch('https://api.ruseo.cn/api/random?action=string&length=16&min=1&max=100&count=1&charset=ABC123&uppercase=true&lowercase=true&numbers=true&symbols=false&avoid_ambiguous=false&unique=true&list=%E8%8B%B9%E6%9E%9C%2C%E9%A6%99%E8%95%89%2C%E6%A9%98%E5%AD%90&sides=6&type=ssq&format=hex&encoding=hex')
  .then(res => res.json())
  .then(data => console.log(data));

返回说明

实际返回内容以接口脚本处理结果为准。

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "route": "random",
        "example": true
    }
}

返回参数说明

参数名	类型	说明	示例值
`action`	string	执行的操作类型	`string`
`result`	string	主要结果（字符串/密码/UUID等）	`aB3xK9mP`
`results`	array	多个结果（number/pick/dice/shuffle/lottery多注时）
`length`	number	生成长度	`16`
`entropy`	number	信息熵（bits）	`95.2`
`strength`	string	密码强度(password时)：very_weak/weak/moderate/strong/very_strong	`strong`
`total`	number	总和(dice时)	`21`
`average`	number	平均值(dice时)	`3.5`
`red`	array	红球号码(lottery时)	`3,12,18,25,33`
`blue`	array	蓝球号码(lottery时)	`7`
`digits`	array	数字序列(fc3d/pl5时)	`3,8,1`
`type`	string	彩票/操作子类型	`ssq`
`count`	number	生成数量	`1`
`pool_size`	number	候选池大小(pick时)	`3`
`uuid_result`	string	UUID结果(uuid时)	`550e8400-e29b-41d4-a716-446655440000`

调试参数

请求方式接口地址 key (可选，用于统计个人调用) action length min max count charset uppercase lowercase numbers symbols avoid_ambiguous unique list sides type format encoding

响应结果

◔ --

点击左侧“发送请求”查看结果...