Minecraft
查询种子引擎支持版本和结构
GET
/minecraft/seed/versions公开访问
访问类别：匿名 API，可携带 Token 使用独立额度
响应
200 Cubiomes 原版 Java 规则预测，缓存 3600 秒
application/json
{
"type": "object",
"properties": {
"edition": {
"type": "string",
"enum": [
"java"
]
},
"engine": {
"type": "string",
"enum": [
"cubiomes"
]
},
"revision": {
"type": "string"
},
"versions": {
"type": "array",
"items": {
"type": "string"
}
},
"dimensions": {
"type": "array",
"items": {
"type": "string"
}
},
"structures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"label": {
"type": "string"
},
"dimension": {
"type": "string"
},
"since": {
"type": "string"
}
},
"required": [
"type",
"label",
"dimension",
"since"
]
}
},
"accuracy": {
"type": "string"
}
},
"required": [
"edition",
"engine",
"revision",
"versions",
"dimensions",
"structures",
"accuracy"
]
}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"
]
}422 请求校验或执行失败
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/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/minecraft/seed/versions'
HTTP 200
content-type: application/json
content-encoding: gzip
cache-control: public, max-age=3600
{
"edition": "java",
"engine": "cubiomes",
"revision": "e61f90580cbdd883214a8054670dacae655e59c0",
"versions": [
"1.16.5",
"1.17.1",
"1.18.2",
"1.19.2",
"1.19.4",
"1.20.6",
"1.21.1",
"1.21.3",
"1.21.4"
],
"dimensions": [
"overworld",
"nether",
"end"
],
"structures": [
{
"type": "village",
"label": "村庄",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "desert_pyramid",
"label": "沙漠神殿",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "jungle_temple",
"label": "丛林神庙",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "swamp_hut",
"label": "沼泽小屋",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "igloo",
"label": "雪屋",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "ocean_ruin",
"label": "海底废墟",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "shipwreck",
"label": "沉船",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "monument",
"label": "海底神殿",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "mansion",
"label": "林地府邸",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "outpost",
"label": "掠夺者前哨站",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "ruined_portal",
"label": "废弃传送门",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "ancient_city",
"label": "远古城市",
"dimension": "overworld",
"since": "1.19.2"
},
{
"type": "trail_ruins",
"label": "古迹废墟",
"dimension": "overworld",
"since": "1.20.6"
},
{
"type": "trial_chambers",
"label": "试炼密室",
"dimension": "overworld",
"since": "1.21.1"
},
{
"type": "stronghold",
"label": "要塞",
"dimension": "overworld",
"since": "1.16.5"
},
{
"type": "fortress",
"label": "下界要塞",
"dimension": "nether",
"since": "1.16.5"
},
{
"type": "bastion",
"label": "堡垒遗迹",
"dimension": "nether",
"since": "1.16.5"
},
{
"type": "ruined_portal_nether",
"label": "下界废弃传送门",
"dimension": "nether",
"since": "1.16.5"
},
{
"type": "end_city",
"label": "末地城",
"dimension": "end",
"since": "1.16.5"
}
],
"accuracy": "原版默认生成规则预测；结构已检查放置规则与生物群系，地形高度、洞穴及方块布局需要游戏验证。模组、数据包和跨版本生成区域可能产生差异。"
}错误示例
curl --silent --show-error -X PATCH -H 'User-Agent: simpleWebUtils-example/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/minecraft/seed/versions'
HTTP 405
content-type: application/json
content-encoding: gzip
cache-control: no-store
{
"error": {
"code": "METHOD_NOT_ALLOWED",
"message": "接口不支持该请求方法"
}
}在线调试
调用示例
curl -X GET 'https://oit.sh/minecraft/seed/versions'
响应
等待发送请求
配置上方请求参数后点击「发送请求」查看实时响应
快捷键：Ctrl / ⌘ + Enter