Wide Worlds (1.0.0)

Download OpenAPI specification:

put-props

Update props on a world

Authorizations:
bearerAuth
path Parameters
worldId
required
integer

Numeric ID of the world to update props on

Request Body schema: application/json
required

Array of props to update

Array
id
integer

ID of the prop

wid
integer

ID of the world the prop belongs to

uid
integer

ID of the user the prop belongs to

date
integer

Creation/modification timestamp (ms) of the prop

x
number

X coordinate of the prop (in meters)

y
number

Y coordinate of the prop (in meters)

z
number

Z coordinate of the prop (in meters)

ya
number

Yaw of the prop (in radians)

pi
number

Pitch of the prop (in radians)

ro
number

Roll of the prop (in radians)

name
string

Model name of the prop

desc
string

Description of the prop

act
string

Action field of the prop

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • null
]

post-props

Create props on a world

Authorizations:
bearerAuth
path Parameters
worldId
required
integer

Numeric ID of the world to create props on

Request Body schema: application/json
required

Array of props to create

Array
id
integer

ID of the prop

wid
integer

ID of the world the prop belongs to

uid
integer

ID of the user the prop belongs to

date
integer

Creation/modification timestamp (ms) of the prop

x
number

X coordinate of the prop (in meters)

y
number

Y coordinate of the prop (in meters)

z
number

Z coordinate of the prop (in meters)

ya
number

Yaw of the prop (in radians)

pi
number

Pitch of the prop (in radians)

ro
number

Roll of the prop (in radians)

name
string

Model name of the prop

desc
string

Description of the prop

act
string

Action field of the prop

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • null
]

delete-props

Delete props from a world

Authorizations:
bearerAuth
path Parameters
worldId
required
integer

Numeric ID of the world to delete props from

Request Body schema: application/json
required

Array of prop IDs to delete

Array
integer

Responses

Request samples

Content type
application/json
[
  • 0
]

Response samples

Content type
application/json
[
  • null
]

login

Authenticate a user based on the provided credentials

Request Body schema: application/json
required

Credentials for user authentication

username
string

Username in plain text

password
string

Password in plain text

Responses

Request samples

Content type
application/json
{
  • "username": "John",
  • "password": "p.4SsW0r-*D"
}

Response samples

Content type
application/json
{
  • "id": 3247,
  • "role": "citizen",
  • "token": "eyJhbGciOiJ...kVUQjE"
}

get-worlds

Get the list of available worlds

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
[]

get-world

Get information about a single world

Authorizations:
bearerAuth
path Parameters
worldId
required
integer

Numeric ID of the world to get

Responses

Response samples

Content type
application/json
{}

get-world-elevation

Get terrain elevation data for a single page a of a single world

Authorizations:
bearerAuth
path Parameters
worldId
required
integer

Numeric ID of the world to get

x
required
integer

Page position along the X axis

z
required
integer

Page position along the Z axis

Responses

Response samples

Content type
application/json
[
  • {
    }
]

get-world-texture

Get terrain texture data for a single page a of a single world

Authorizations:
bearerAuth
path Parameters
worldId
required
integer

Numeric ID of the world to get

x
required
integer

Page position along the X axis

z
required
integer

Page position along the Z axis

Responses

Response samples

Content type
application/json
[
  • {
    }
]

get-world-water

Get water elevation data for a single page a of a single world

Authorizations:
bearerAuth
path Parameters
worldId
required
integer

Numeric ID of the world to get

x
required
integer

Page position along the X axis

z
required
integer

Page position along the Z axis

Responses

Response samples

Content type
application/json
[
  • {
    }
]

get-users

Get the list of all users

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
[
  • {
    }
]

post-user

Create a new user

Authorizations:
bearerAuth
Request Body schema: application/json
required

Payload to create a new user

name
required
string

Name of the user

email
required
string

Email address bound to this user account

role
required
string

Role of the user, can be one of admin, citizen or tourist

password
required
any

Password of the user in clear text, will be stored hashed and salted.

privilegePassword
string

Optional (null for none) privilege password of the user in clear text, will be stored hashed and salted.

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "email": "string",
  • "role": "string",
  • "password": null,
  • "privilegePassword": "string"
}

Response samples

Content type
application/json
{
  • "id": 3247,
  • "name": "johndoe",
  • "email": "john.doe@domain.com",
  • "role": "citizen"
}

get-user

Get information about a single user

Authorizations:
bearerAuth
path Parameters
userId
required
integer

Numeric ID of the user to get

Responses

Response samples

Content type
application/json
{
  • "id": 3247,
  • "name": "johndoe",
  • "email": "john.doe@domain.com",
  • "role": "citizen"
}

put-user

Update a user

Authorizations:
bearerAuth
path Parameters
userId
required
integer

Numeric ID of the user to update

Request Body schema: application/json
required

Payload to update the user

name
string

Name of the user

email
string

Email address bound to this user account

role
string

Role of the user, can be one of admin, citizen or
tourist

password
any

Password of the user in clear text, will be stored hashed and salted.

privilegePassword
string

Optional (null for none) privilege password of the user in clear text, will be stored hashed and salted.

Responses

Request samples

Content type
application/json
{
  • "name": "johndoe",
  • "email": "john.doe@domain.com",
  • "role": "citizen",
  • "password": null,
  • "privilegePassword": "string"
}

Response samples

Content type
application/json
{
  • "id": 3247,
  • "name": "johndoe",
  • "email": "john.doe@domain.com",
  • "role": "citizen"
}

delete-user

Delete a single user

Authorizations:
bearerAuth
path Parameters
userId
required
integer

Numeric ID of the user to delete

Responses

Response samples

Content type
application/json
{
  • "id": 3247,
  • "name": "johndoe",
  • "email": "john.doe@domain.com",
  • "role": "citizen"
}