©

Le site officiel de l'ASGP


Logo de l'Association de Soutien à Gloire & Pouvoir

Voir autres sites de la communauté de G&P

idenfitication

login

password

ok
nouveau joueur
password perdu

parties en cours

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 










 
 

Forums

Les forums de Gloire et Pouvoir.

Vous n'êtes pas identifié(e).

#1 22/12/2011 12:02:51

Ilmir
Main du Roy
Blason de la Maison Ilmir

Interfaces externes

Le but de ce topic est de décrire les différentes interfaces de communication avec le site de Gloire & Pouvoir.
Si vous n'y comprennez rien, c'est qu'il n'est pas fait pour vous smile

Hors ligne

#2 22/12/2011 12:15:03

Ilmir
Main du Roy
Blason de la Maison Ilmir

Re : Interfaces externes

Données générées par le moteur :

Fichiers communs

url d'accès : /rapports/[partie]/COMMUN[tour].txt
 * partie (requis) : numéro de la partie
 * tour (requis) : numéro de tour

format du contenu : texte brut

remarques :
 * pas de commun au tour 0
 * tous les communs ne sont pas disponible (souvent uniquement les 5 derniers tours)

Fichiers bilans

url d'accès : /parties/bilan.php?id=[partie]&tour=[tour]&mode=[mode]&seigneur=[seigneur]&key=[key]
 * partie (requis) : numéro de la partie
 * tour (requis) : numéro du tour
 * mode (optionnel) : "file" pour télécharger au format txt, affichage en ligne sinon
 * seigneur (optionnel ) : identifiant du seigneur, pris en compte uniquement si clé remplie, identifiant correspondant au seigneur  sur la partie du joueur loggé sinon
 * key (optionnel) : clé d'autorisation d'accès aux données fichiers du seigneur pour la partie ( disponible dans "Modifier mes données")

format du contenu : texte brut

remarques :
 * pas de bilan au tour 0

Fichiers tours

url d'accès : /parties/tour.php?id=[partie]&tour=[tour]&mode=[mode]&seigneur=[seigneur]&key=[key]
 * partie (requis) : numéro de la partie
 * tour (requis) : numéro du tour
 * mode (optionnel) : "file" pour télécharger au format txt, affichage en ligne sinon
 * seigneur (optionnel ) : identifiant du seigneur, pris en compte uniquement si clé remplie, identifiant correspondant au seigneur  sur la partie du joueur loggé sinon
 * key (optionnel) : clé d'autorisation d'accès aux données fichiers du seigneur pour la partie ( disponible dans "Modifier mes données")

format du contenu : texte brut

remarques :
 * pas de fichier tour au tour 0

Hors ligne

#3 22/12/2011 12:19:37

Ilmir
Main du Roy
Blason de la Maison Ilmir

Re : Interfaces externes

Informations globales :

Passage des tours :

url d'accès : /php5/status.php

format du contenu : JSON
 * ENCOURS : 1 le tour est en cours de traitement, 0 sinon
 * DATE : Heure du dernier changement de status au format Y-m-d h:i:s

remarques : n/a

Liste des parties :

url d'accès : /parties/data.php?state=[state]
 * state (optionnel) : Etat des parties - encours (par défaut), terminees ou all

format du contenu : XML
version 1 :
 + parties
   * version : version du flux 
   + partie
     * nom : nom de la partie
     * id : identifiant de la partie
     * tour : numéro du dernier tour résolu
     * map : type de carte ( 1 => scandie, 2 => europe, 3 => MO, 4 => france)
     * roi : nom du seigneur vainqueur, vide si en cours

remarques : n/a

Hors ligne

#4 22/12/2011 12:19:40

Ilmir
Main du Roy
Blason de la Maison Ilmir

Re : Interfaces externes

Informations de parties :

Flux complet de données :

url d'accès : /transition/index.php?module=parties&group=data&action=paramV[version]&partie=[partie]&map=[map]&encodage=[encodage]&detailmap=[detailmap]&ordres=[ordres]&login=[login]&password=[password]
 * version (requis) : version du flux de données ( 1 ou 2 )
 * partie (requis) : numéro de partie
 * map (optionnel ) : type de carte ( 1 => Scandie, 2 => Europe, 3 => MO, 4 => France)
 * encodage (optionnel) : encodage utilisé pour les données ( 'light', par défaut, encode avec htmlspecialchars , 'urlencode' encode avec urlencode )
 * detailmap (optionnel) : si ok, la topologie de la carte sera incluse
 * ordres (optionnel) : si ok, les ordres déjà passés seront inclus
 * login (optionnel) : si remplit avec password, permet de s'authentifier, sinon utilisation de l'utilisateur actuel
 * password (optionnel) : cf login

format du contenu : XML
version 2
  + partie
     - nom : nom de la partie
     - id : numéro de la partie
     - tour : numéro du dernier tour résolu
     - roi : nom du roi si la partie est finie
     - aidecamp : login du joueur étant aide de camp sur la partie
     - aidemail : mail du joueur étant aide de camp sur la partie
     + joueur ( si joueur connecté, ayant un seigneur non mort sur la partie )
        - id : identifiant du seigneur joué
        - login : login du joueur
        - impglobal : pour les parties 2.x, valeur de l'imposition par défaut
        - redglobal : pour les parties 2.x, valeur de la redistribution globale
        - retost : % avant retraite d'un ost
        - retguet : % avant retraite d'un guet
        - retpay : % avant retraite d'une garnison de paysans
... to complet ...

remarques :
 * Si pas de numéro de partie : Code erreur 1
 * Si aucune partie correspondant au numéro fourni : Code erreur 2
 * Si map rempli et ne correspondant pas à la partie : Code erreur 3

Hors ligne

#5 22/12/2011 12:19:45

Ilmir
Main du Roy
Blason de la Maison Ilmir

Re : Interfaces externes

Réservé

Hors ligne

#6 22/12/2011 12:19:48

Ilmir
Main du Roy
Blason de la Maison Ilmir

Re : Interfaces externes

Réservé

Hors ligne

Pied de page des forums

 

Version des règles : 2.12.1

Gloire et Pouvoir est membre du Fog Of War


c'est vous qui le d?tes

TDJ Gamers'room
Donnez votre avis ? propos de Gloire et Pouvoir sur JAC Donnez votre avis sur Jeux-Web.com

Au del?  des PBeM

Logo jeu-en-ligne-gratuis.net Logo jeux-alternatifs.com

Les partenaires

ludimail Vae Victis

 
Pour un jeu diff?rent dans une ambiance m?di?val
Nawakim - Un jeu de role en ligne m?di?val
 
twitter facebook