Difference between revisions of "API"

From Tycoon Gaming
Line 13: Line 13:
  
 
=== Get world information for online players ===
 
=== Get world information for online players ===
 +
Returns a list of all online players with positional data.
 +
 +
Their current mode of transportation and some other details are also included.
 +
 +
This endpoint is used to produce the servers livemap.
 +
 
  GET /status/map/positions.json
 
  GET /status/map/positions.json
 
  object
 
  object
Line 32: Line 38:
  
 
=== Get server details and online players ===
 
=== Get server details and online players ===
 +
Returns the servers name and details, as well as data for every player online.
 +
 +
This endpoint is used to produce the server list: http://connect.tycoon.community/
 +
 
  GET /status/widget/players.json
 
  GET /status/widget/players.json
 
  object
 
  object
Line 51: Line 61:
  
 
=== Get resource configurations ===
 
=== Get resource configurations ===
 +
This can be used to easily get vector data for routes etc. in certain jobs
 +
Not all resources have viewable configs
 +
 
  GET /status/config/[resource]
 
  GET /status/config/[resource]
  returns a raw lua file
+
  returns a raw .lua file dump
 
[[Category:Development]]
 
[[Category:Development]]

Revision as of 20:36, 21 September 2019

Transport Tycoon API

Root API URI is the servers address

API is available per server instance

Legend

type name (data type and a property name)
type? name (data type may vary based on data context)
type! name (data might not exist based on data context)

Note: Array data types do not contain named properties, the names used here are for clarifiation

Get world information for online players

Returns a list of all online players with positional data.

Their current mode of transportation and some other details are also included.

This endpoint is used to produce the servers livemap.

GET /status/map/positions.json
object
- int time
- array[array player] data
-- string name
-- int source
-- int user_id
-- vec3 position
-- object vehicle
--- int vehicle_class
--- string vehicle_type
--- int! model
--- string! vehicle_label
--- string! vehicle_name
-- object job
--- string group
--- string name

Get server details and online players

Returns the servers name and details, as well as data for every player online.

This endpoint is used to produce the server list: http://connect.tycoon.community/

GET /status/widget/players.json
object
- object server
-- string name
-- string motd
-- string number
-- string region
-- string beta
-- int limit
- array[array player] players
-- string name
-- int source
-- int user_id
-- string? avatar
-- bool staff
-- string job_name
-- bool whitelist

Get resource configurations

This can be used to easily get vector data for routes etc. in certain jobs Not all resources have viewable configs

GET /status/config/[resource]
returns a raw .lua file dump