Web Services: exemple Escacs

De Cacauet Wiki
Salta a la navegació Salta a la cerca

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
status: ok/error
msg: detalls del error
uid: identificador d'usuari
/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.