创建MMO房间

POST

/api/open/mmo/room/new

最后修改时间：2026-04-12 05:24:04

创建一个新的 MMO 房间，系统自动选择负载最低的边缘节点。
Token 必须包含 mmo scope。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

{
    "protocol": "udp"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.yearnstudio.cn/api/open/mmo/room/new' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "protocol": "udp"
}'

返回响应

🟢200

application/json

房间创建成功

Body

示例

{
    "status": "success",
    "data": {
        "connect_key": "a3f1e2c4b5d67890a3f1e2c4b5d67890",
        "edge_url": "mmo.yearnstudio.cn:8082",
        "room_id": "550e8400-e29b-41d4-a716-446655440000",
        "protocol": "udp"
    }
}

🟠400ProtocolNotSupported

🟠401Unauthorized

🟠403Forbidden

修改于 2026-04-12 05:24:04

加入MMO房间

所有操作