趣味工具
按骰子表达式掷骰并返回每颗点数
GET
/roll/{dice}公开访问curl
支持 3d6、d20、1d20+5、2d6+1d8-1。每组 1–100 颗、2–1000 面，总共最多 100 颗、10 组。点数来自 crypto.getRandomValues 的拒绝采样。 访问类别：匿名 API，可携带 Token 使用独立额度
请求参数
dicepath必填- string · 最短：2 字符 · 最长：64 字符
_formatquery- 响应格式为 json 或 text；_format=svg 返回 JSON。plain 是 text 的别名。未识别的值继续按 Accept 协商。
- string · 可选：json、text
_colorquery- 控制 text 响应的 ANSI 颜色。0、false、off、no 关闭；省略或其他值保留。
- string · 可选：0、false、off、no
响应
200 请求处理结果
application/json
{
"type": "object",
"properties": {
"expression": {
"type": "string"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"sides": {
"type": "integer"
},
"sign": {
"anyOf": [
{
"type": "number",
"enum": [
1
]
},
{
"type": "number",
"enum": [
-1
]
}
]
},
"rolls": {
"type": "array",
"items": {
"type": "integer"
}
},
"subtotal": {
"type": "integer"
}
},
"required": [
"count",
"sides",
"sign",
"rolls",
"subtotal"
]
}
},
"modifier": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"expression",
"groups",
"modifier",
"total"
]
}400 请求校验或执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}401 凭据无效、停用、过期或缺少所需 Token
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}403 需要管理员 Token
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}413 请求体过大
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}415 请求内容类型无效
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}429 请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}500 内部执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}响应示例
运行命令前，将环境变量 BASE_URL 设置为站点地址。
成功响应
curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/2.0.1' -H 'Accept: application/json' "$BASE_URL"'/roll/3d6'
HTTP 200
content-type: application/json
content-encoding: gzip
cache-control: no-store
{
"expression": "3d6",
"groups": [
{
"count": 3,
"sides": 6,
"sign": 1,
"rolls": [
1,
5,
3
],
"subtotal": 9
}
],
"modifier": 0,
"total": 9
}错误示例
curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/2.0.1' -H 'Accept: application/json' "$BASE_URL"'/roll/invalid%20value'
HTTP 400
content-type: application/json
content-encoding: gzip
cache-control: no-store
{
"error": {
"code": "INVALID_INPUT",
"message": "骰子表达式只支持 NdS、可选修饰和加减组合，例如 3d6 或 1d20+5",
"issues": [
{
"location": "path",
"field": "dice",
"code": "invalid_value",
"message": "骰子表达式只支持 NdS、可选修饰和加减组合，例如 3d6 或 1d20+5"
}
]
}
}curl 访问示例
curl、wget、HTTPie 默认得到 text/plain。示例展示纯文本输出。
命令与输出
curl --silent --show-error -H 'User-Agent: curl/8.7.1' "$BASE_URL"'/roll/3d6?_color=0'
HTTP 200 content-type: text/plain; charset=utf-8 content-encoding: gzip cache-control: no-store 3d6 3d6: 3 2 6 modifier 0 total 11
在线调试
调用示例
curl -X GET 'https://oit.sh/roll/3d6'
响应
等待发送请求
配置上方请求参数后点击「发送请求」查看实时响应
快捷键：Ctrl / ⌘ + Enter