VlmHttp

Cette page essaye de documenter les bonnes pratiques pour VLM et les accès http.

VLM est une application ouverte avec beaucoup d'information accessible assez librement par navigateur, ou tout logiciel parlant le http. Il y a cependant des bonnes pratiques à respecter, afin d'assurer la pérénité de votre développement et celle de VLM.

• UTILISER les WebServices. S'il vous en manque, demandez (ouvrez un ticket ou faites un mail) C'est la meilleure façon de faire progresser tout le monde.

• Le format texte est gardé pour la compatibilité provisoirement mais n'est pas garanti.

• les requêtes http doivent avoir un User-Agent correct

  • celui du navigateur client,
  • ou encore un User-Agent qui identifie l'outil et sa version).

• VLM stocke pour quelques jours les IP des joueurs qui se connectent et passent des ordres. C'est nécessaire pour les cas (rares) de contestations ou encore quand il ya suspicion de bug dans VLM afin de retracer les commandes passées par le logiciel client.

• Il n'est pas recommandé de faire des développements qui conduiraient à avoir la même adresse IP pour de nombreux utilisateurs (i.e. qu'un serveur externe fasse proxy).

• Si c'est inévitable, il faut le signaler aux développeurs. Utiliser la fonctionnalité de VLM prévue à cet effet, en renseignant dans les en-têtes http les propriétés suivantes :

  • VLM_PROXY_AGENT : le nom de votre outil
  • VLM_PROXY_PASS : un mot de passe spécial communiqué par les admins de VLM
  • VLM_CLIENT_IP : l'adresse IP "vraie" du joueur.