Web Services: exemple Escacs

Article anterior: Web Services

Objectius

Proposem un exercici amb web services. Volem fer un joc d'escacs disponible per diversos clients (aplicació browser desktop, aplicació mòbil, etc.)

En l'anterior article Web Services es proposa treballar amb MongoDB i utilitzar el framework CherryPy. Fes-li un cop d'ull per veure exemple pertinent.

Passem a especificar les diverses funcions que necessitem per implementar el WS:

Objectes del servei

Els objectes de més alt nivell (usuaris, partides) corresponen a les col·leccions de MongoDB.

• Usuari:
  • uid
  • Nick
  • email
  • estat
• Partida:
  • pid
  • jugador_blanques: uid
  • jugador_negres: uid
  • fitxes: [] array amb les diverses peces del taulell i les seves posicions
    • { color:'b', tipus:'peo', fila:2, col:3 }
    • ...
• torn: nº de torn (parells=mou blanca, senars=mou negra)
• inici: data + hora d'inici de partida (timestamp)

Especificació

API

Endpoint	IN (GET o POST+JSON)	OUT (JSON)
/partida	pid: id de partida (GET)	status: ok/error msg: detalls del error partida: totes les dades de la partida
/en_espera		status: ok/error msg: detalls del error usuaris: [] array d'usuaris en espera
/juga	uid_adversari: uid de la persona amb qui ens volem enfrontar uid_usuari: la nostra uid	status: ok/error msg: detalls del error partida: totes les dades de la partida
/login	nick: pseudònim de l'usuari email: adreça electrònica msg	status: ok/error msg: detalls del error usuaris: [] array d'usuaris en espera
/mou	pid: id de partida fila_inici col_inici fila_dst col_dst	status: ok/error msg: detalls del error partida: totes les dades de la partida

Recomanacions

• Instal·la mongodb, pymongo i cherrypy
• Fes un script que crei una partida amb les figures, etc.