加入MMO房间

POST

/api/open/mmo/room/join

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

加入一个已存在的 MMO 房间。同一账号多端加入时会分配临时 UID（assigned_uid）。
Token 必须包含 mmo scope，且与创建房间的应用 ID 一致。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
    "room_id": "550e8400-e29b-41d4-a716-446655440000",
    "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/join' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "room_id": "550e8400-e29b-41d4-a716-446655440000",
    "protocol": "udp"
}'

返回响应

🟢200

application/json

加入房间成功

Body

示例

普通加入同账号二次加入（分配临时 UID）

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

🟠400

🟠403

🟠401Unauthorized

🟠404NotFound

修改于 2026-04-12 05:23:55

接入文档

创建MMO房间