Web API
Web API ARK используется клиентом для получения списка официальных серверов и отображения новостей. Доступ к каждой конечной точке можно получить, отправив простой HTTP-запрос GET. HTTPS не поддерживается. Некоторые конечные точки имеют суффикс ".ini", но их содержимое не в формате INI-файла. Имена конечных точек чувствительны к регистру. Все конечные точки API размещены на официальном сервере ARK по адресу [1].
версия
Возвращает текущую последнюю версию игры в виде простой строки. Пример: URL-адрес http://arkdedicated.com/version
возвращает Ошибка Lua в Модуль:Version на строке 68: bad argument #2 to 'format' (string expected, got nil).
для версии игры Ошибка Lua в Модуль:Version на строке 68: bad argument #2 to 'format' (string expected, got nil)..
версия/основная
Если вас интересует только основной номер версии, используйте этот http://arkdedicated.com/version/major
. Пример: <st
. Версии игр, которые отличаются младшим номером версии, но имеют один и тот же основной номер версии, должны быть совместимы (с точки зрения подключения, модов, сохранения игр и т. д.).
officialserverstatus.ini
Эта конечная точка содержит текст, обычно отображаемый в верхнем левом углу внутриигрового браузера сервера ark, и отображает состояние и текущую версию всех официальных серверов Ark. Возвращаемый текст отформатирован в ArkML.
Пример: URL-адрес http://arkdedicated.com/officialserverstatus.ini
возвращает:
Статус сети Официального сервера ARK: <RichColor Color="0, 1, 0, 1">Healthy (v223.2)</>
officialtributeenabled.html
http://arkdedicated.com/officialtributeenabled.html
Эта конечная точка указывает, включена ли передача данных (передача данных) в Официальной серверной сети.
news.ini
http://arkdedicated.com/news.ini
Эта конечная точка содержит текст, обычно отображаемый в правом верхнем углу главного меню Ark, и отображает новости, касающиеся Ark. Возвращаемый текст также форматируется в ArkML. Текст больше не обрабатывается игрой, но из текущих наблюдений из него можно извлечь дополнительные данные.
После синтаксического анализа ArkML каждая новостная запись разделяется двумя строками возврата каретки (\r\n\r\n). Каждая запись начинается со строки даты, за которой следует двоеточие, и заканчивается текстом записи. Строка даты состоит из полного названия месяца, за которым следует пробел, а затем день месяца без начальных символов. В формате strftime данные могут быть представлены в виде %B %-d
.
officialservers.ini
http://arkdedicated.com/officialservers.ini
Эта конечная точка содержит список официальных хостов сервера. IP-адрес каждого узла сервера указан в отдельной строке, за которым следует двойная косая черта (//), а затем короткое имя сервера. На каждом официальном хостинге работает до четырех игровых серверов. Порты запросов для каждого игрового сервера находятся на стандартном серверном порту Steam, плюс 2, плюс 4 и плюс 6 (27015, 27017, 27019, 27021). См. протокола запроса сервера, чтобы узнать, как получить от них информацию.
*Эта конечная точка не используется непосредственно игрой.
globaladmins.txt
http://arkdedicated.com/globaladmins.txt
Эта конечная точка содержит список официальных администраторов сервера.
globaladmins.txt (Snail Games)
http://arksnail.snail.com/globaladmins.txt
Эта конечная точка содержит список официальных администраторов серверов на серверах, которыми управляет Snail Games.
conquestbanlist.txt
http://arkdedicated.com/conquestbanlist.txt
Эта конечная точка содержит список учетных записей, которые глобально запрещены в официальной сети conquest server.
*Говорят, что эта конечная точка больше не обновляется.
xboxbanlist.txt
http://arkdedicated.com/xboxbanlist.txt
Эта конечная точка содержит список учетных записей, которые глобально запрещены в официальной серверной сети Xbox.
ps4banlist.txt
http://arkdedicated.com/ps4banlist.txt
Эта конечная точка содержит список учетных записей, которые глобально заблокированы в официальной серверной сети PS4.
banlist.txt
http://arkdedicated.com/banlist.txt
Эта конечная точка содержит список учетных записей, которые глобально запрещены в официальной серверной сети.
dynamicconfig.ini
http://arkdedicated.com/dynamicconfig.ini
Эта конечная точка содержит множители, используемые для официальных событий Evolution.
pcnotification.html
http://arkdedicated.com/pcnotification.html
http://arkdedicated.com/notification.html
(xbox)[>источник?]
http://arkdedicated.com/ps4notification.html
http://arkdedicated.com/switchnotification.html
Конечные точки, зависящие от платформы, для внутриигровых объявлений на сервере.
Ark Mobile
Ark Mobile использует тот же домен для получения официальных серверов. Вместо того, чтобы быть в формате ini, этот файл отформатирован в формате JSON.
http://arkdedicated.com/mobile/cache/officialserverlist.json
Эта конечная точка предоставляет список всех официальных серверов. Каждый сервер в списке использует следующий формат JSON.
{ "AllowDownloadItems":-2084667264, "Region":"NA", "IP":"34.241.86.216", "NPEnvironment":"[2a05:d018:b8b:6f00:cca0:866e:7335:8be]", "MinorBuildId":1, "MaxPlayers":60, "ClusterId":"{\r\n\t\"NumReservedSlots\": 60,\r\n\t\"NumReservedPlayers\": 1,\r\n\t\"ClusterId\": \"ark\",\r\n\t\"Difficulty\": \"Hard\",\r\n\t\"Mode\": \"PVE\",\r\n\t\"REGION\": \"EU\"\r\n}", "MapName":"M_TheIsland", "SessionIsPve":false, "NPSessionId":"26", "AllowDownloadChars":75, "NumPlayers":1, "LastUpdated":1535927396441, "BuildId":159, "Port":7810, "DayTime":"21:46", "GameMode":"ARK", "Name":"Gauntlet (PVE-Hard-EU)" }
Если NumReservedSlots
равно максимальному количеству игроков, клиент сделает так, чтобы этот сервер отображался как сервер только премиум-класса. Изменение идентификатора кластера с "ark" приведет к тому, что сервер не будет отображаться в клиенте. Неизвестно, что означает AllowDownloadItems
, NPEnvironment
или AllowDownloadChars
.
Xbox
http://arkdedicated.com/xbox/cache/officialserverlist.json
http://arkdedicated.com/xbox/cache/unofficialserverlist.json
Эти конечные точки содержат массивы объектов в формате JSON для каждого официального и неофициального сервера Xbox.
Пример объекта с удаленными IP-адресами и доменами:
{ "AllowDownloadItems":1, "IP":"192.0.2.1", "Service":"https://example.com:89", "MinorBuildId":1, "MaxPlayers":70, "ClusterId":"XboxPrimitivePlusPVE", "Sandbox":"RETAIL", "MapName":"TheCenter", "SessionIsPve":1, "LatencyPort":9996, "AllowDownloadChars":1, "NumPlayers":3, "LastUpdated":1539545767997, "BuildId":1777, "Port":9992, "SearchHandle":"ec008fff-b668-4d34-88c6-f6c84c10334b", "DayTime":"19754", "Legacy":1, "GameMode":"GameMode_PrimitivePlus_C", "Name":"PVE-EU-XboxPrimitivePlus24", "SearchTags":["crossplayallowxbox"] }
Nintendo Switch
http://arkdedicated.com/switch/cache/officialserverlist.json
http://arkdedicated.com/switch/cache/unofficialserverlist.json
Playstation
http://arkdedicated.com/sotfps4/cache/officialserverlist.json