All endpoints require the headers:
authorization: "token TOKEN_KEY_HERE"
Endpoint: POST /traverse/<direction>
Direction must be n
e
s
or w
(not case sensitive). If you input a different direction or one that is not possible to move in you will simply be told that there is no room in that direction. We halt your request so you do not get a cooldown for inputting an incorrect direction.
Response:
{
"room_id": 6,
"title": "A misty room",
"description": "You are standing on grass and surrounded by a dense mist. You can barely make out the exits in any direction.",
"coordinates": "(60,58)",
"elevation": 0,
"terrain": "NORMAL",
"players": [],
"items": [],
"exits": [
"n",
"w"
],
"cooldown": 15,
"errors": [],
"messages": [
"You have walked south.",
"Wise Explorer: -50% CD"
]
}
Endpoint: GET /rooms
Returns every single room with the description/title, coordinates, and the resulting room for every exit. Null in an exit means we either haven't explored it, or there is no exit that direction.
Response:
[
{
"id": 0,
"title": "A brightly lit room",
"description": "You are standing in the center of a brightly lit room. You notice a shop to the west and exits to the north, south and east.",
"coords": {
"x": 60,
"y": 60
},
"exits": {
"n": 10,
"w": 1,
"e": 4,
"s": 2
},
"elevation": 0,
"terrain": "NORMAL"
},
{
"id": 2,
"title": "A misty room",
"description": "You are standing on grass and surrounded by a dense mist. You can barely make out the exits in any direction.",
"coords": {
"x": 60,
"y": 59
},
"exits": {
"n": 0,
"w": null,
"e": null,
"s": 6
},
"elevation": 0,
"terrain": "NORMAL"
}
]
Endpoint: GET /room/<id or name>
Returns the room based on the provided id or name.
Response:
{
"id": 1,
"title": "Shop",
"description": "You are standing in a small shop. A sign behind the mechanical shopkeeper says 'WILL PAY FOR TREASURE'.",
"coords": {
"x": 59,
"y": 60
},
"exits": {
"n": null,
"w": null,
"e": 0,
"s": null
},
"elevation": null,
"terrain": null
}
Endpoint: POST /autotraverse
Your character will start exploring maps that we do not have in our database.
Response:
{
"Message": "Auto Traverse has started."
}
Endpoint: DELETE /autotraverse
Your character will stop auto traversing the unexplored rooms in our database. Gives up control and stops using your Token.
Response:
{
"Message": "Auto Traverse has been stopped."
}