API web

De ARK: Survival Evolved Wiki
Aller à : navigation, rechercher


Les API web pour ARK sont utilisées par le client pour obtenir une liste des serveurs officiels et en obtenir de nouveaux. Chaque entrée est accessible en envoyant une simple requête GET HTTP. HTTPS n'est pas supporté. Certaines entrées sont suffixées avec une extension ".ini", mais leur contenu n'est pas celui d'un document au format .ini. Les noms des entrées sont sensibles à la casse. Toutes les API sont hébergées sur un serveur ARK officiel à arkdedicated.com

version[modifier | modifier le wikicode]

Renvoie la dernière version du jeu par une simple ligne. Exemple: l'URL http://arkdedicated.com/version returns 329.51 pour la version de jeu de la 329.51.

version/major[modifier | modifier le wikicode]

Si seule la dernière version majeure vous intéresse, utilisez http://arkdedicated.com/version/major à la place. Exemple: 329. Les versions de jeu dont la version diffère en version mineure mais partagent la même version majeure devraient être compatibles (en termes de connexion, mods, sauvegardes, etc...).

officialserverstatus.ini[modifier | modifier le wikicode]

Cette entrée contient le texte généralement affiché par le coin supérieur gauche du navigateur serveur ARK, et affiche la santé et la version en cours des serveurs ARK officiels. Le texte en retour est formaté en ArkML.

Exemple: l'URL http://arkdedicated.com/officialserverstatus.ini renvoie:

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

officialtributeenabled.html[modifier | modifier le wikicode]

http://arkdedicated.com/officialtributeenabled.html

Cette entrée spécifie si les transferts d'offandes sont activées sur le réseau des serveurs officiels.

news.ini[modifier | modifier le wikicode]

http://arkdedicated.com/news.ini

Cette entrée contient le texte affiché généralement dans le coin droit supérieur du menu principal ARK, et affiche les nouvelles concernant ARK. Le texte en retour est formaté en ArkML. Le texte n'est pas utilisé par le jeu, mais des observations peuvent être ajoutées à partir d'ici.

Après avoir avoir fait l'analyse syntaxique du ArkML,chaque nouvelle entrée est séparée par deux champs de ligne de portage (\r\n\r\n). Chaque entrée commence par un argument de date, suivi par deux points, et finit par le texte d'entrée. Le champ de date consiste en le nom du mois entier suivi d'un espace, puis le jour du mois dans caractère supplémentaire. Au format strftime, la date peut être représentée par %B %-d

officialservers.ini[modifier | modifier le wikicode]

http://arkdedicated.com/officialservers.ini

Cette entrée contient la liste des serveurs hôtes. L'adresse IP de chaque serveur hôte est listée sur une ligne séparée, suivie d'une double oblique retour (//) et un nom bref du serveur. Jusque quaatre hôtes serveur tournent par hôte officiel. Les ports entrants de chaque serveur de jeu sont sur les ports serveurs standards Steam, plus 2, plus 4 et plus 6 (27015, 27017, 27019, 27021). Vois la Page de protocole des requêtes serveurs pour en savoir plus.

*Cette entrée n'est pas utilisée actuellement.

globaladmins.txt[modifier | modifier le wikicode]

http://arkdedicated.com/globaladmins.txt

Cette entrée contient la liste des administrateurs serveurs officiels.

globaladmins.txt (Snail Games)[modifier | modifier le wikicode]

http://arksnail.snail.com/globaladmins.txt

Cette entrée contient la liste des administrateurs serveurs officiels des serveurs Snail Games.

conquestbanlist.txt[modifier | modifier le wikicode]

http://arkdedicated.com/conquestbanlist.txt

Cette entrée contient la liste des compte qui sont bannis du réseau des serveurs conquête officiels.

*Cette entrée n'est plus mise à jour.

xboxbanlist.txt[modifier | modifier le wikicode]

http://arkdedicated.com/xboxbanlist.txt

Cette entrée contient la liste des comptes bannis du réseau des serveurs officiels Xbox.

ps4banlist.txt[modifier | modifier le wikicode]

http://arkdedicated.com/ps4banlist.txt

Cette entrée contient la liste des comptes bannis du réseau des serveurs officiels PS.

banlist.txt[modifier | modifier le wikicode]

http://arkdedicated.com/banlist.txt

Cette entrée contient la liste des comptes bannis du réseau des serveurs officiels.

dynamicconfig.ini[modifier | modifier le wikicode]

http://arkdedicated.com/dynamicconfig.ini

Cette entrée contient les multiplicateurs utilisés pour les événements Evolution officiels.

pcnotification.html[modifier | modifier le wikicode]

http://arkdedicated.com/pcnotification.html

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

http://arkdedicated.com/ps4notification.html

http://arkdedicated.com/switchnotification.html

Entrée spécifique aux plateformes pour les annonces larges aux serveurs en jeu

Ark Mobile[modifier | modifier le wikicode]

Ark Mobile utilise le même domaine pour obtenir les serveurs officiels. Au lieu d'être au format INI, le fichier est au format JSON.

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

Cette entrée founir la liste de tous les serveurs officiels. Chaque serveur dans la liste utilise le format JSON suivant:

{
  "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)"
}

Si NumReservedSlots est égal au nombre maximum de joueurs, le client fera apparaître le serveur comme serveur réservé aux premiums. Changer l'ID du cluster en-dehors d'ARK fera qu'il n'apparaîtra pas chez le client. On ne sait pas ce que AllowDownloadItems, NPEnvironment, ou AllowDownloadChars veulent dire.

Xbox[modifier | modifier le wikicode]

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

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

Ces entrées contiennent les tableaux JSOn des objets pour chaque serveur Xbox officiel ou non-officiel.

Exemple d'objets avec des IP rattachées aux domaines:

{  
  "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[modifier | modifier le wikicode]

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

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