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[ | ]
Renvoie la dernière version du jeu par une simple ligne. Exemple: l'URL http://arkdedicated.com/version
returns 345.19
pour la version de jeu de la 345.19.
version/major[ | ]
Si seule la dernière version majeure vous intéresse, utilisez http://arkdedicated.com/version/major
à la place. Exemple: 345
. 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[ | ]
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[ | ]
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[ | ]
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[ | ]
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[ | ]
http://arkdedicated.com/globaladmins.txt
Cette entrée contient la liste des administrateurs serveurs officiels.
globaladmins.txt (Snail Games)[ | ]
http://arksnail.snail.com/globaladmins.txt
Cette entrée contient la liste des administrateurs serveurs officiels des serveurs Snail Games.
conquestbanlist.txt[ | ]
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[ | ]
http://arkdedicated.com/xboxbanlist.txt
Cette entrée contient la liste des comptes bannis du réseau des serveurs officiels Xbox.
ps4banlist.txt[ | ]
http://arkdedicated.com/ps4banlist.txt
Cette entrée contient la liste des comptes bannis du réseau des serveurs officiels PS.
banlist.txt[ | ]
http://arkdedicated.com/banlist.txt
Cette entrée contient la liste des comptes bannis du réseau des serveurs officiels.
dynamicconfig.ini[ | ]
http://arkdedicated.com/dynamicconfig.ini
Cette entrée contient les multiplicateurs utilisés pour les événements Evolution officiels.
pcnotification.html[ | ]
http://arkdedicated.com/pcnotification.html
http://arkdedicated.com/notification.html
xbox?
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[ | ]
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[ | ]
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[ | ]
http://arkdedicated.com/switch/cache/officialserverlist.json
http://arkdedicated.com/switch/cache/unofficialserverlist.json
|