Web API

提供: ARK: Survival Evolved Wiki
移動先: 案内検索


ARKのWeb APIは、公式サーバーのリストを取得してニュースを表示するためにクライアントによって使用されます。 各エンドポイントには、単純なHTTPGETリクエストを送信することでアクセスできます。 HTTPSはサポートされていません。 一部のエンドポイントには「.ini」拡張子が付いていますが、その内容はINIファイルの形式ではありません。 エンドポイント名では大文字と小文字を区別されます。 すべてのAPIエンドポイントは、arkdedicated.comの公式ARKサーバーでホストされています

バージョン[編集 | ソースを編集]

現在の最新のゲームバージョンを単純な文字列として返します。 例:URL http://arkdedicated.com/versionは、ゲームバージョンの326.6に対して326.6を返します。

バージョン/メジャー[編集 | ソースを編集]

メジャーバージョン番号のみに関心がある場合は、代わりにこのhttp://arkdedicated.com/version/majorを使用してください。 例:326。マイナーバージョン番号が異なるが、同じメジャーバージョン番号を共有するゲームバージョンは互換性がある必要があります(接続、改造、ゲームの保存などの点で)。

officialserverstatus.ini[編集 | ソースを編集]

このエンドポイントには、ゲーム内のarkサーバーブラウザーの左上隅に通常表示されるテキストが含まれ、すべての公式Arkサーバーの正常性と現在のバージョンが表示されます。戻りテキストはArkMLでフォーマットされています。

例: URL http://arkdedicated.com/officialserverstatus.ini は:

ARK Official Server Network Status: <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を解析した、各ニュースエントリは2つのキャリッジリターンラインフィード(\r\n\r\n)で区切られます。 各エントリは、日付文字列で始まり、コロンが続き、エントリのテキストで終わります。 日付文字列は、完全な月の名前、スペース、および先頭文字のない月の日で構成されます。 strftime形式では、日付は%B %-dとして表すことができます。

officialservers.ini[編集 | ソースを編集]

http://arkdedicated.com/officialservers.ini

このエンドポイントには、公式サーバーホストのリストが含まれています。 各サーバーホストのIPアドレスは別々の行にリストされ、その後にスラッシュ(//)が続き、サーバー名が短くなります。 各公式ホストで最大4つのゲームサーバーが実行されます。 各ゲームサーバーのクエリポートは、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

このエンドポイントには、SnailGamesが管理するサーバー上の公式サーバー管理者のリストが含まれています。

conquestbanlist.txt[編集 | ソースを編集]

http://arkdedicated.com/conquestbanlist.txt

このエンドポイントには、公式コンクエストサーバーネットワークからグローバルに禁止されているアカウントのリストが含まれています。

*このエンドポイントはもう更新されていないと言われています。

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

このエンドポイントには、OfficialEvolutionイベントに使用される乗数が含まれています

pcnotification.html[編集 | ソースを編集]

http://arkdedicated.com/pcnotification.html

http://arkdedicated.com/notification.htmlxbox?

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がプレーヤーの最大数と等しい場合、クライアントはこのサーバーをプレミアム専用サーバーとして表示します。 クラスタIDを「ark」から変更すると、サーバーがクライアントに表示されなくなります。AllowDownloadItemsNPEnvironmentAllowDownloadCharsの意味は不明です。

Xbox[編集 | ソースを編集]

http://arkdedicated.com/xbox/cache/officialserverlist.json

http://arkdedicated.com/xbox/cache/unofficialserverlist.json

これらのエンドポイントには、公式および非公式のXboxサーバーごとにオブジェクトのJSON配列が含まれています。

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