Skip to content

Retrieve Room List

Send Request

Send a GET request to http://mc.miaaoo.com/list with empty request parameters.

Example Code

import requests

response = requests.get('http://mc.miaaoo.com/list')

print(response.text)

Tip

When the returned status code is 200 or 201, it indicates a successful request. The returned data is a JSON-formatted string containing the room list.

Response Data

The returned data is a JSON-formatted string containing the room list, including the following fields:

  • results: List of rooms, where each room contains the following fields:
    • sessionRef: An object containing the session ID
      • name: Session ID
    • createTime: Creation time in ISO 8601 formatted string
    • id: Room UUID
    • customProperties: Custom properties of the room, including the following fields:
      • hostName: Host's Xbox ID
      • ownerId: Host's XUID
      • version: Room version
      • worldName: World name
      • worldType: Game mode, which can be Survival/Adventure/Creative/Spectator
      • MemberCount: Number of players in the room
      • MaxMemberCount: Maximum number of players allowed in the room
      • BroadcastSetting: Room broadcast settings, 3: Friends of friends, 2: Friends only, 1: Invitation only. Only rooms with a value of 3 can be joined by external players.
      • isHardcore: Whether it is Hardcore mode
    • roomfrom: Room source, currently with the following values: 2: MultiMC23, 3: gouhope, 4: HelloMC25, 5: HelloMC25a

Example

{
    "results": [
        {
            "sessionRef": {
                "name": "1234567890"
            },
            "createTime": "2021-08-17T10:00:00.000Z",
            "id": "12345678-1234-123456789012",
            "customProperties": {
                "hostName": "XboxID",
                "ownerId": "1234567890123456",
                "version": "1.16.5",
                "worldName": "world",
                "worldType": "Survival",
                "MemberCount": 1,
                "MaxMemberCount": 10,
                "BroadcastSetting": 3,
                "isHardcore": false
            },
            "roomfrom": 2
        },
        ...
    ]
}