GET /minecraft/seed/slime

访问类别：匿名 API，可携带 Token 使用独立额度

请求参数

seedquery必填: 完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807; string · 完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807
versionquery: string · 默认值："1.21.4" · 可选：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
chunkXquery: integer / null · 默认值：0 · 最小值：-1875000 · 最大值：1874999
chunkZquery: integer / null · 默认值：0 · 最小值：-1875000 · 最大值：1874999
radiusquery: integer / null · 默认值：8 · 最小值：0 · 最大值：16

响应

200 Cubiomes 原版 Java 规则预测，缓存 3600 秒

application/json

{
  "type": "object",
  "properties": {
    "seed": {
      "type": "string",
      "example": "262",
      "description": "完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"
    },
    "version": {
      "type": "string"
    },
    "dimension": {
      "type": "string",
      "enum": [
        "overworld"
      ]
    },
    "radius": {
      "type": "number"
    },
    "center": {
      "type": "object",
      "properties": {
        "chunkX": {
          "type": "number"
        },
        "chunkZ": {
          "type": "number"
        }
      },
      "required": [
        "chunkX",
        "chunkZ"
      ]
    },
    "chunks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "chunkX": {
            "type": "number"
          },
          "chunkZ": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "slime": {
            "type": "boolean"
          }
        },
        "required": [
          "chunkX",
          "chunkZ",
          "x",
          "z",
          "slime"
        ]
      }
    }
  },
  "required": [
    "seed",
    "version",
    "dimension",
    "radius",
    "center",
    "chunks"
  ]
}

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/slime?seed=262&version=1.21.4&chunkX=0&chunkZ=0&radius=8'

HTTP 200
content-type: application/json
content-encoding: gzip
cache-control: public, max-age=3600

{
  "seed": "262",
  "version": "1.21.4",
  "dimension": "overworld",
  "radius": 8,
  "center": {
    "chunkX": 0,
    "chunkZ": 0
  },
  "chunks": [
    {
      "chunkX": -8,
      "chunkZ": -8,
      "x": -128,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": -7,
      "chunkZ": -8,
      "x": -112,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": -6,
      "chunkZ": -8,
      "x": -96,
      "z": -128,
      "slime": true
    },
    {
      "chunkX": -5,
      "chunkZ": -8,
      "x": -80,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": -4,
      "chunkZ": -8,
      "x": -64,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": -3,
      "chunkZ": -8,
      "x": -48,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": -2,
      "chunkZ": -8,
      "x": -32,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": -1,
      "chunkZ": -8,
      "x": -16,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": 0,
      "chunkZ": -8,
      "x": 0,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": 1,
      "chunkZ": -8,
      "x": 16,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": 2,
      "chunkZ": -8,
      "x": 32,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": 3,
      "chunkZ": -8,
      "x": 48,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": 4,
      "chunkZ": -8,
      "x": 64,
      "z": -128,
      "slime": true
    },
    {
      "chunkX": 5,
      "chunkZ": -8,
      "x": 80,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": 6,
      "chunkZ": -8,
      "x": 96,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": 7,
      "chunkZ": -8,
      "x": 112,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": 8,
      "chunkZ": -8,
      "x": 128,
      "z": -128,
      "slime": false
    },
    {
      "chunkX": -8,
      "chunkZ": -7,
      "x": -128,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": -7,
      "chunkZ": -7,
      "x": -112,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": -6,
      "chunkZ": -7,
      "x": -96,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": -5,
      "chunkZ": -7,
      "x": -80,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": -4,
      "chunkZ": -7,
      "x": -64,
      "z": -112,
      "slime": true
    },
    {
      "chunkX": -3,
      "chunkZ": -7,
      "x": -48,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": -2,
      "chunkZ": -7,
      "x": -32,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": -1,
      "chunkZ": -7,
      "x": -16,
      "z": -112,
      "slime": true
    },
    {
      "chunkX": 0,
      "chunkZ": -7,
      "x": 0,
      "z": -112,
      "slime": true
    },
    {
      "chunkX": 1,
      "chunkZ": -7,
      "x": 16,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": 2,
      "chunkZ": -7,
      "x": 32,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": 3,
      "chunkZ": -7,
      "x": 48,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": 4,
      "chunkZ": -7,
      "x": 64,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": 5,
      "chunkZ": -7,
      "x": 80,
      "z": -112,
      "slime": false
    },
    {
      "chunkX": 6,
      "chunkZ": -7,
      "x": 96,
   
… 已截断，完整响应 30246 字符

错误示例

curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/minecraft/seed/slime?seed=invalid+value&version=1.21.4&chunkX=0&chunkZ=0&radius=8'

HTTP 400
content-type: application/json
content-encoding: gzip
cache-control: no-store

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "参数无效",
    "issues": [
      {
        "location": "query",
        "field": "seed",
        "code": "custom",
        "message": "种子必须为有符号 64 位十进制整数"
      }
    ]
  }
}

按种子查询 Java 版史莱姆区块

请求参数

响应

响应示例

成功响应

错误示例

在线调试

响应