Web API

Материал из ARK Survival Evolved Wiki
Перейти к навигации Перейти к поиску


Web API ARK используется клиентом для получения списка официальных серверов и отображения новостей. Доступ к каждой конечной точке можно получить, отправив простой HTTP-запрос GET. HTTPS не поддерживается. Некоторые конечные точки имеют суффикс ".ini", но их содержимое не в формате INI-файла. Имена конечных точек чувствительны к регистру. Все конечные точки API размещены на официальном сервере ARK по адресу [1].

версия

Возвращает текущую последнюю версию игры в виде простой строки. Пример: URL-адрес http://arkdedicated.com/version возвращает 344.8 для версии игры 344.8.

версия/основная

Если вас интересует только основной номер версии, используйте этот http://arkdedicated.com/version/major. Пример: 344. Версии игр, которые отличаются младшим номером версии, но имеют один и тот же основной номер версии, должны быть совместимы (с точки зрения подключения, модов, сохранения игр и т. д.).

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