Webservice che mette a disposizione un metodo di lettura per conoscere le promozioni attive sull’app id utilizzato dal client e da un metodo per l’inserimento di un nuovo checkin lato utente. Il metodo read ritorna tutti i livelli di promozione disponibili, specificando all’interno dei diversi items, il numero dei checkin necessari per aver diritto a quella promozioni. Il metodo per l’ottenimento di un’offerta checkin, richiede naturalmente uno user token ed eroga, automaticamente, l’offerta checkin a cui quell’utente a diritto, in base all’history dei checkin effettuati all’interno del sistema (anche attraverso interfacce diverse).
Url webservice
http://www.overplace.com/wsdl/promozioni [1]
Metodo 1
promozioniRead
Parametri
- ws_auth_token: Client token ottenuto dal Client Login Webservice [2] (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
|
1 2 3 4 5 6 7 8 9 10 |
<?xml version="1.0" encoding="ISO-8859-1"?> <SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"> <SOAP-ENV:Body> <ns3575:promozioniRead xmlns:ns3575="http://tempuri.org"> <ws_auth_token xsi:type="xsd:string">v4xhVi4antPqK3UAQbCXNn3WMI8W+36eafdWBqzfh4o=</ws_auth_token> <idapp xsi:type="xsd:string">CJ50</idapp> <response_type xsi:type="xsd:string">json</response_type> </ns3575:promozioniRead> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
Esempio Response lato Client
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
<response> <promozione> <message>Richiedi codice promozione</message> <secodaryMessage>Inserisci il tuo numero di cellulare per ricevere via SMS il codice promozione</secodaryMessage> <item> <title>Hai diritto ad una consulenza gratuita</title> <subtitle>Ogni Check-in</subtitle> </item> <item> <title>Hai diritto ad un sopralluogo gratuito</title> <subtitle>Ogni 10 Check-in</subtitle> </item> </promozione> </response> |
Response in formato Json
|
1 |
{"promozione":{"message":"Richiedi codice promozione","secodaryMessage":"Inserisci il tuo numero di cellulare per ricevere via SMS il codice promozione","item":{"title":"Hai diritto ad una consulenza gratuita","subtitle":"Ogni Check-in"}}} |
Metodo 2
promozioniGet
Parametri
- ws_auth_token: Client token ottenuto dal Client Login Webservice [2] (string).
- idapp: Application id delle vetrina Overplace sulla quale il client vuole operare (es. CJ50)(string).
- user_token: Token identificativo di un utente Overplace, si ottiene attraverso i metodi per il login di un utente esterno [3], e per la registrazione [4].
- response type : formato della risposta, i parametri accettati sono “xml” o “json”(string).
Esempio Request lato Client
|
1 2 3 4 5 6 7 8 9 10 |
<?xml version="1.0" encoding="ISO-8859-1"?> <SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"> <SOAP-ENV:Body> <ns7599:promozioniGet xmlns:ns7599="http://tempuri.org"> <ws_auth_token xsi:type="xsd:string">I2X/bXJJmeyalFoI0bF/ByqIt+NZupOSWtslZa35KhQ=</ws_auth_token> <idapp xsi:type="xsd:string">CJ50</idapp> <user_token xsi:type="xsd:string">DGWBOaxGuURZoAjACmDM8hQI4JfuPlWi407OY+EJtBfF3Y+GBicNXMDgrT91EEN+7DXJ7viIKCOb2/MjBa8U+8y8Je5s9BTkSOyl4YHUrAV5QKAf68flWzdGQbZjoNjXzbpEoTiIzXiKwQPM2PyfLJfwAbeI05sxRt93Fz6j+2ElTHG96xQMc1HaMPNXjJYEBINamWcgoEDBwFAolZfp1A==</user_token> <response_type xsi:type="xsd:string">json</response_type></ns7599:promozioniGet> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
Esempio Response lato Client
|
1 2 3 4 5 |
<response> <type>success</type> <code>1C4 005 A22 Y</code> <message>Hai diritto ad una consulenza gratuita</message> </response> |
Response in formato Json
|
1 |
{"type":"success","code":"A2N 0V6 22Y","message":"Hai diritto ad una consulenza gratuita"} |