API Anathas

Forum > Vos idées et propositions > API Anathas

Première page Page précédente 1/1 Page suivante Dernière page

ARRG de Arche Kingdom
Avatar
▽▽▽
41e
Tetra₃
API Anathas 29/06/20 17:13

Anathas propose une API basique en lecture seulement qui peut être utilisée pour la création de bots ou d'outils d'intégration pour la communauté.


Pour utiliser l'API vous devez d'abord demander un 'token' qui identifiera votre projet. Seuls les projets concrets et bénéficiant à la communauté seront acceptés.


La documentation de l'API est disponible ci-dessous.

Citer CiterLien LienReporter Reporter
Citer CiterLien LienReporter Reporter
ARRG de Arche Kingdom
Avatar
▽▽▽
41e
Tetra₃
Bases de l'API 29/06/20 17:19

Bases de l'API


Une API HTTP, retournant une réponse en JSON.


Les requêtes, GET uniquement, sont faites à l'adresse :

https://www.anathas.com/ajax/api.php


Paramètres nécessaires


  • v=1 (la version de l'API, seule 1 est supporté pour le moment)
  • token=abcdefg (le token unique, fourni lorsque vous aurez été autorisé à utiliser l'API)
  • request= ... (définit le type de requête API)
  • Des paramètres additionnels sont nécessaires selon le type de requête.


Les types de requêtes supportés sont :

  • game-data
  • player-data
  • read-shoutbox

Le fonctionnement de chaque requêtes est détaillé ensuite.


Réponse

La réponse est un objet JSON avec 2 champs.

  • success = true/false indique si la requête a été exécutée avec succès
  • error, si success est false, contient un message d'erreur
  • data, si success est true, contient le contenu de la réponse


Exemple de requête :

https://www.anathas.com/ajax/api.php?v=1&token=<xxx>&request=player-data&ID=3606


Réponse :

{"success":true,"data":{"techa":"150","techi":"80","techc":"76","rank":37,"prech":"260","cycles":62}}


Exemple de requête :

https://www.anathas.com/ajax/api.php?v=1&token=<xxx>&request=player-data&ID=99999


Réponse :

{"success":false,"error":"ce joueur n'existe pas"}

Modifié le 30/06/20 19:03 Citer CiterLien LienReporter Reporter
Modifié le 30/06/20 19:03
Citer CiterLien LienReporter Reporter
ARRG de Arche Kingdom
Avatar
▽▽▽
41e
Tetra₃
Types de requête disponibles 29/06/20 17:29

Types de requête disponibles


game-data

Retourne des informations générales sur la partie en cours (pour le moment, le cycle en cours).


Aucun paramètre n'est accepté.




player-data

Retourne des informations sur un joueur en particulier.

Le paramètre ID (l'identifiant du joueur) est nécessaire.


La réponse contient les champs :

  • techa : le niveau de technologie agricole
  • techi : le niveau de technologie industrielle
  • techc : le niveau de technologie commerciale
  • ptech : le nombre de points de recherche
  • rank : la position dans le classement (tel qu'affichée sur le profil du joueur)
  • cycles : le nombre de cycles d'ancienneté du joueur



read-shoutbox

Permet de lire la shoutbox.


Paramètres :

  • box : détermine quelle boite lire (seules les boites 0 1 et 2 sont supportées), optionel et 0 par défaut
  • fromID : détermine le message le plus ancien qui doit être retourné, non inclusif. Par exemple si fromID = 100, seuls les messages avec un ID de 101 ou plus seront retournés. Permet donc d'éviter les doublons lorsque plusieurs requêtes à l'API sont faites à la suite.


Réponse :

{

untilID : l'identifiant du message le plus récent retourné (à utiliser comme paramètre fromID de la prochaine requête).

messages : un tableau de messages

}


Chaque message est un objet :

{

ID : l'identifiant du message

joueur : le pseudo du joueur ayant envoyé le message

message : le message

date : le timestamp UNIX représentant le moment où le message a été posté, fuseau horaire Europe/Paris

}

Modifié le 29/06/20 17:34 Citer CiterLien LienReporter Reporter
Modifié le 29/06/20 17:34
Citer CiterLien LienReporter Reporter

Première page Page précédente 1/1 Page suivante Dernière page

Forum > Vos idées et propositions > API Anathas


Pour participer à la communauté, connectez-vous ou créez un compte