Web Services: exemple Escacs - Historial de revisió

Enric: /* Especificació */

2020-02-28T15:47:50Z

Especificació

2020-02-28T15:47:33Z

Especificació

2020-02-28T15:22:57Z

Especificació

2020-02-28T15:15:49Z

Especificació

2020-02-28T15:14:50Z

Especificació

2015-06-12T15:49:48Z

Objectes del servei

2015-05-04T18:33:36Z

Especificació

2015-04-22T16:13:13Z

Servei bàsic amb CherryPy

2015-03-23T16:24:01Z

Recomanacions

2015-03-23T15:32:56Z

Recomanacions

@@ Línia 63: / Línia 63: @@
 | /mou
 | ''uid'': usuari<br>''pid'': id de partida<br>''fila_inici''<br>''col_inici''<br>''fila_dst''<br>''col_dst''
-| ''status'': ok/error<br>''msg'': detalls del error<br>''partida'': totes les dades de la partida
+| ''status'': ok/error<br>''msg'': detalls del error<br>''partida'': [] totes les dades de la partida
 |}

@@ Línia 47: / Línia 47: @@
 | /login
 | ''nick'': pseudònim de l'usuari<br>''email'': adreça electrònica
-| ''status'': ok/error<br>''msg'': detalls del error<br>''uid'': identificador d'usuari
+| ''status'': ok/error<br>''msg'': detalls del error<br>''uid'': identificador d'usuari<br>''pid'': partida oberta
 |-
 | /en_espera
@@ Línia 59: / Línia 59: @@
 | /partida
 | ''pid'': id de partida (GET)
-| ''status'': ok/error<br>''msg'': detalls del error<br>''partida'': totes les dades de la partida
+| ''status'': ok/error<br>''msg'': detalls del error<br>''partida'': [] totes les dades de la partida
 |-
 | /mou

← Versió més antiga		Revisió del 15:22, 28 feb 2020
Línia 31:		Línia 31:

	== Especificació ==		== Especificació ==
		+	El flux de la partida serà el següent:
		+	# Quan un usuari entra, se li assigna una partida en espera amb un identificador (pid).
		+	# L'usuari pot veure les pid en espera mitjançant el WS (/en_espera)
		+	# L'usuari pot seleccionar una de les partides amb el que es considera iniciada la partida.
		+	# L'oponent pot consultar si algú ha acceptat la seva partida mitjançant el WS (/partida)
		+	# Ambdós jugadors estan assabentats de l'estat de la partida, poden procedir a moure les peces adequadament.
		+

	{\| border="1" class="wikitable" style="border-collapse:collapse;"		{\| border="1" class="wikitable" style="border-collapse:collapse;"

@@ Línia 44: / Línia 44: @@
 | /en_espera
+|
-| ''status'': ok/error<br>''msg'': detalls del error<br>''usuaris'': [] array d'usuaris en espera
+| ''status'': ok/error<br>''msg'': detalls del error<br>''usuaris'': [] array de partides en espera (pid + nick)
 |-
 | /juga

@@ Línia 38: / Línia 38: @@
 ! OUT (JSON)
 |-
-| /partida
+| /login
-| ''pid'': id de partida (GET)
+| ''nick'': pseudònim de l'usuari<br>''email'': adreça electrònica
-| ''status'': ok/error<br>''msg'': detalls del error<br>''partida'': totes les dades de la partida
+| ''status'': ok/error<br>''msg'': detalls del error<br>''uid'': identificador d'usuari
 |-
 | /en_espera
@@ Línia 47: / Línia 47: @@
 |-
 | /juga
-| ''uid_adversari'': uid de la persona amb qui ens volem enfrontar<br>''uid_usuari'': la nostra uid
+| ''pid'': pid de la partida en la que vols entrar.<br>''uid_usuari'': la nostra uid
 | ''status'': ok/error<br>''msg'': detalls del error<br>''partida'': totes les dades de la partida
 |-
-| /login
+| /partida
-| ''nick'': pseudònim de l'usuari<br>''email'': adreça electrònica
+| ''pid'': id de partida (GET)
-| ''status'': ok/error<br>''msg'': detalls del error<br>''uid'': identificador d'usuari
+| ''status'': ok/error<br>''msg'': detalls del error<br>''partida'': totes les dades de la partida
 |-
 | /mou

@@ Línia 25: / Línia 25: @@
 *** { color:'b', tipus:'peo', fila:2, col:3 }
 *** ...
-* torn: nº de torn (parells=mou blanca, senars=mou negra)
+** torn: nº de torn (parells=mou blanca, senars=mou negra)
-* inici: data + hora d'inici de partida (timestamp)
+** inici: data + hora d'inici de partida (timestamp)
 <br>

← Versió més antiga		Revisió del 16:13, 22 abr 2015
Línia 121:		Línia 121:
	cherrypy.quickstart( Escacs() )		cherrypy.quickstart( Escacs() )
	</syntaxhighlight>		</syntaxhighlight>
		+
		+
		+	== Testejant l'exemple amb UnitTest ==
		+	Podeu anar a [[Unit Tests en Python]] per veure com efectuar tests sobre aquest WS.

@@ Línia 79: / Línia 79: @@
 == Recomanacions ==
 * Instal·la mongodb, pymongo i cherrypy
-* Fes un script que crei una partida amb les figures, etc.
+* Crea el servidor bàsic amb ''cherrypy'' com en l'exemple del final.
 <br>