Web API

From ARK: Survival Evolved Wiki
Jump to: navigation, search


Ark's Web API is used by the client to get a list of official servers and display news. Each endpoint can be accessed by sending a simple HTTP GET request. HTTPS is not supported. Some endpoints are suffixed by a ".ini" extension, but their content is not in the format of an INI file. Endpoint names are case sensitive. All API endpoints are hosted on the official Ark server at:

http://arkdedicated.com

version[edit | edit source]

Returns the current latest game version as a simple string. Example: the URL http://arkdedicated.com/version returns 275.42 for game version of 275.42.

version/major[edit | edit source]

If you are only interested in the major version number, use this http://arkdedicated.com/version/major instead. Example: 223. Game versions that differ in minor version numbers but share the same major version number should be compatible (in terms of connecting, mods, save games, etc.).

officialserverstatus.ini[edit | edit source]

This endpoint contains the text typically displayed in the upper left hand corner of the in-game ark server browser, and displays the health and current version of all the official Ark servers. The return text is formatted in ArkML.

Example: the URL http://arkdedicated.com/officialserverstatus.ini returns:

ARK Official Server Network Status: <RichColor Color="0, 1, 0, 1">Healthy (v223.2)</>

news.ini[edit | edit source]

http://arkdedicated.com/news.ini

This endpoint contains the text typically displayed in the upper right hand corner of Ark's main menu, and displays news regarding Ark. The return text is also formatted in ArkML. The text is not processed any further by the game, but from current observations additional data can be parsed from it.

After parsing the ArkML, each news entry is separated by two carriage return line feeds (\r\n\r\n). Each entry begins with a date string, followed by a colon, and ends with the entry's text. The date string consists of the full month name followed by a space and then the day of the month with no leading characters. In strftime format, the date can be represented as %B %-d

officialservers.ini[edit | edit source]

http://arkdedicated.com/officialservers.ini

This endpoint contains the list of official server hosts. The IP address of each server host is listed on a separate line, followed by a double forward slash (//) and then a short server name. Up to four game servers run on each official host. The query ports for each game server are on Steam's standard server port, plus 2, plus 4, and plus 6 (27015, 27017, 27019, 27021). See the server query protocol page to learn how to get information from them.