Prenotazioni

Il webservice per le prenotazioni consente ai client di ottenere la lista dei servizi prenotabili e di costruire, step dopo step, un vero e proprio processo di prenotazione. La procedura prevede l’utilizzo dei metodi del webservice in ordine prestabilito. Ciascun webservice fornisce infatti uno o più token indispensabili per procedere con lo step successivo. Andiamo ad analizzare uno ad uno i diversi step del processo di prenotazione tramite webservice.

Url webservice

http://www.overplace.com/wsdl/prenotazioni

Metodo 1

serviziList

Ritorna la lista dei servizi prenotabili

Parametri

  • ws_auth_token: Client token ottenuto dal Client Login Webservice (string).
  • idapp: Application id delle vetrina Overplace sulla quale il client vuole operare (es. CJ50)(string).
  • response type : formato della risposta, i parametri accettati sono “xml” o “json”(string).

Esempio Request lato Client

Esempio Response lato Client

 Response in formato Json

 

Metodo 2

giorniList

Ritorna la lista dei giorni prenotabili in base al servizio scelto

Parametri

  • ws_auth_token: Client token ottenuto dal Client Login Webservice (string).
  • idapp: Application id delle vetrina Overplace sulla quale il client vuole operare (es. CJ50)(string).
  • id_servizio : Id del servizio scelto, parametro ritornato dal metodo precedente(int)
  • data_inizio_servizio : Data di creazione del servizio scelto, parametro ritornato dal metodo precedente(string)
  • token_servizio : Token del servizio scelto, parametro ritornato dal metodo precedente(string)
  • ws_token: Token identificativo del processo di prenotazione, parametro ritornato dal metodo precedente(string)
  • response type : formato della risposta, i parametri accettati sono “xml” o “json”(string).

Esempio Request lato Client

Esempio Response lato Client

 Response in formato Json

 

Metodo 3

orariList

Ritorna la lista degli orari prenotabili in base al servizio e al giorno scelto

Parametri

  • ws_auth_token: Client token ottenuto dal Client Login Webservice (string).
  • idapp: Application id delle vetrina Overplace sulla quale il client vuole operare (es. CJ50)(string).
  • token_servizio : Token del servizio scelto, parametro ritornato dal metodo serviziList(string)
  • data_inizio_giorno : Data in formato Y-m-d del giorno scelto, parametro ritornato dal metodo precedente(string)
  • token_giorno : Token identificativo del giorno scelto,parametro ritornato dal metodo precedente(string)
  • numero_persone : Numero delle persone per il quale si sta prenotando il servizio scelto nel giorno selezionato. Deve essere inferiore al parametro max_disponibilita del giorno scelto ritornato dal metodo giorniList(int)
  • ws_token: Token identificativo del processo di prenotazione, parametro ritornato dal metodo precedente(string)
  • response type : formato della risposta, i parametri accettati sono “xml” o “json”(string).

Esempio Request lato Client

Esempio Response lato Client

 Response in formato Json

 

Metodo 4

riepilogoPrenotazione

Riepilogo dei parametri scelti per la prenotazion (servizio, giorno, orario e numero di persone)

Parametri

  • ws_auth_token: Client token ottenuto dal Client Login Webservice (string).
  • idapp: Application id delle vetrina Overplace sulla quale il client vuole operare (es. CJ50)(string).
  • token_servizio : Token del servizio scelto, parametro ritornato dal metodo serviziList(string)
  • data_inizio_giorno : Data in formato Y-m-d del giorno scelto, parametro ritornato dal metodo giorniList(string)
  • token_giorno : Token identificativo del giorno scelto,parametro ritornato dal metodo giorniList(string)
  • data_inizio_orario : Orario scelto in formato H:i , parametro ritornato dal metodo orariList(string)
  • token_orario : Token identificativo dell’orario scelto,parametro ritornato dal metodo orariList(string)
  • numero_persone : Numero delle persone per il quale si sta prenotando il servizio scelto nel giorno selezionato. Deve essere inferiore al parametro max_disponibilita del giorno scelto ritornato dal metodo giorniList(int)
  • ws_token: Token identificativo del processo di prenotazione, parametro ritornato dal metodo precedente(string)
  • response type : formato della risposta, i parametri accettati sono “xml” o “json”(string).

Esempio Request lato Client

Esempio Response lato Client

 Response in formato Json

 

Metodo 5

prenota

Inserisce una nuova prenotazione in base ai parametri passati (servizio, giorno, ora, numero persone, promemoria). Nella risposta è contenuto un parametro denominato “action”. Se action è “riepilogo_prenotazione” il processo di prenotazione è andato a buon fine, se invece action è “registrazione_cell”, bisognerà proseguire con il metodo successivo, in quanto l’utente identificato dall’user_token, non ha un cellulare associato al proprio account.

Parametri

  • ws_auth_token: Client token ottenuto dal Client Login Webservice (string).
  • idapp: Application id delle vetrina Overplace sulla quale il client vuole operare (es. CJ50)(string).
  • token_servizio : Token del servizio scelto, parametro ritornato dal metodo serviziList(string)
  • token_giorno : Token identificativo del giorno scelto,parametro ritornato dal metodo giorniList(string)
  • token_orario : Token identificativo dell’orario scelto,parametro ritornato dal metodo orariList(string)
  • ws_token: Token identificativo del processo di prenotazione, parametro ritornato dal metodo precedente(string)
  • note: Stringa contenente le note da comunicare all’esercente riguardanti la prenotazione, può essere una stringa vuota(string)
  • promemoria: Flag che indica se si desidera o meno ricevere un promemoria della prenotazione, valori consentiti 0 = falso, 1 = vero (string)
  • minuti_promemoria : Quanti minuti prima si desidera ricevere il promemoria (0 se promemoria = 0)(int)
  • user_token : Token identificativo di un utente Overplace, si ottiene attraverso i metodi per il login di un utente esterno,  e per la registrazione.
  • response type : formato della risposta, i parametri accettati sono “xml” o “json”(string).

Esempio Request lato Client

Esempio Response lato Client

 Response in formato Json

 Response in caso di utente con cellulare da registrare

 

Metodo 6

registrazione_cell

Associa un numero di cellulare all’account utente rappresentato dallo user_token e, in caso di successo, effettua la prenotazione. Se fallisce la risposta nel campo action è “registrazione_cell”, altrimenti “riepilogo_prenotazione” (leggi la documentazione del metodo “prenota”).

Parametri

  • ws_auth_token: Client token ottenuto dal Client Login Webservice (string).
  • idapp: Application id delle vetrina Overplace sulla quale il client vuole operare (es. CJ50)(string).
  • token_servizio : Token del servizio scelto, parametro ritornato dal metodo serviziList(string)
  • token_giorno : Token identificativo del giorno scelto,parametro ritornato dal metodo giorniList(string)
  • token_orario : Token identificativo dell’orario scelto,parametro ritornato dal metodo orariList(string)
  • cellulare : Numero di telefono cellulare da associare all’account utente che effettua la prenotazione(string).
  • ws_token: Token identificativo del processo di prenotazione, parametro ritornato dal metodo precedente(string)
  • note: Stringa contenente le note da comunicare all’esercente riguardanti la prenotazione, può essere una stringa vuota(string)
  • promemoria: Flag che indica se si desidera o meno ricevere un promemoria della prenotazione, valori consentiti 0 = falso, 1 = vero (string)
  • minuti_promemoria : Quanti minuti prima si desidera ricevere il promemoria (0 se promemoria = 0)(int)
  • user_token : Token identificativo di un utente Overplace, si ottiene attraverso i metodi per il login di un utente esterno,  e per la registrazione.
  • response type : formato della risposta, i parametri accettati sono “xml” o “json”(string).

Esempio Request lato Client

Esempio Response lato Client

 Response in formato Json

Stampa Stampa
Comments are closed.