← 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]}}

呼叫統計

隨機數介面累計被呼叫 59 次 · 今日 0 次。全部介面統計見 呼叫統計頁。

介面路徑今日累計
隨機整數/v1/random/int038
隨機字串/v1/random/string06
UUID/v1/random/uuid03
隨機浮點數/v1/random/float08
不重複抽取/v1/random/shuffle04
介面索引/v1/random00

線上測試

點上面的按鈕,這裡會顯示介面的真實返回。