Il webservice per i Coupon Overplace consente di sapere se sulla vetrina identificata dall’id_app è presente un’offerta coupon. Se l’offerta estiste il metodo couponRead ritorna i dettagli e le condizioni dell’offerta. Il metodo couponGet, invece, serve ad erogare un voucher per il coupon, necessita di un user_token, per identificare l’utente che si aggiudica la promozione e di alcune informazioni, specificate qui sotto, ritornate dal metodo couponRead.
Url webservice
http://www.overplace.com/wsdl/coupon [1]
Metodo 1
couponRead
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> <ns2140:couponRead xmlns:ns2140="http://tempuri.org"> <ws_auth_token xsi:type="xsd:string">qDENoGWxxWmCZNzl2cM2qfsDJenqsgxh9f8zmDx7EJc=</ws_auth_token> <idapp xsi:type="xsd:string">CJ50</idapp> <response_type xsi:type="xsd:string">xml</response_type> </ns2140:couponRead> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
Esempio Response lato Client
|
1 2 3 4 5 6 7 8 9 10 11 12 |
<response> <id>111</id> <image>http://www.overplace.com/files/5191/tc_5191_20130827122058.jpg</image> <title>Lorem Ipsum</title> <sale>Suspendisse facilisis convallis urna, vitae pharetra nisi adipiscing id 50%</sale> <description>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nulla arcu, aliquet vitae metus et, rhoncus varius orci. Proin dapibus felis tellus, sed posuere nibh sodales et. Phasellus neque nisi, convallis interdum bibendum sed, dictum eget eros. Proin interdum nunc in felis consequat, quis ullamcorper leo euismod. Cras a adipiscing neque, a scelerisque purus. Nunc vitae consectetur orci. Suspendisse dui lorem, rutrum at diam a, accumsan tempus odio. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras ultrices, orci ac scelerisque tincidunt, arcu magna tempor nisi, id gravida turpis justo quis orci. Nullam vestibulum mauris sit amet erat convallis, at ultrices libero malesuada. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Mauris eget purus augue. </description> <terms>Mauris quis orci eros. Quisque pellentesque, massa vitae feugiat elementum, tortor enim semper tellus, vel lacinia ipsum tellus vitae mauris. Praesent pulvinar nisi nunc, in scelerisque urna feugiat ut. Etiam elit odio, consequat non semper quis, congue ut lacus. Sed convallis vel nulla adipiscing varius. Nam placerat vulputate diam quis adipiscing. Maecenas mauris dui, pretium vitae ipsum euismod, commodo porta magna. Suspendisse dui velit, mollis id turpis vel, tempus porttitor eros. Ut eget orci posuere, volutpat orci et, egestas urna. Fusce fringilla porta odio, a rutrum lacus. Proin vehicula nibh ac mi euismod, ac dapibus orci facilisis. </terms> <url>http://coupon.overplace.com/consulente-di-innovazione-fabio-furiani</url> <days_available>15</days_available> <date>2013-09-06 14:20:10</date> <token>E+tlHoM8BC5DnZ4co47bzoR+PL0xpUEN1tf4IaAWD+I=</token> </response> |
Response in formato Json
|
1 |
{"id":"111","image":"http:\/\/www.overplace.com\/files\/5191\/tc_5191_20130827122058.jpg","title":"Lorem Ipsum","sale":"Suspendisse facilisis convallis urna, vitae pharetra nisi adipiscing id 50%","description":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nulla arcu, aliquet vitae metus et, rhoncus varius orci. Proin dapibus felis tellus, sed posuere nibh sodales et. Phasellus neque nisi, convallis interdum bibendum sed, dictum eget eros. Proin interdum nunc in felis consequat, quis ullamcorper leo euismod. Cras a adipiscing neque, a scelerisque purus. Nunc vitae consectetur orci. Suspendisse dui lorem, rutrum at diam a, accumsan tempus odio. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras ultrices, orci ac scelerisque tincidunt, arcu magna tempor nisi, id gravida turpis justo quis orci. Nullam vestibulum mauris sit amet erat convallis, at ultrices libero malesuada. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Mauris eget purus augue. ","terms":"Mauris quis orci eros. Quisque pellentesque, massa vitae feugiat elementum, tortor enim semper tellus, vel lacinia ipsum tellus vitae mauris. Praesent pulvinar nisi nunc, in scelerisque urna feugiat ut. Etiam elit odio, consequat non semper quis, congue ut lacus. Sed convallis vel nulla adipiscing varius. Nam placerat vulputate diam quis adipiscing. Maecenas mauris dui, pretium vitae ipsum euismod, commodo porta magna. Suspendisse dui velit, mollis id turpis vel, tempus porttitor eros. Ut eget orci posuere, volutpat orci et, egestas urna. Fusce fringilla porta odio, a rutrum lacus. Proin vehicula nibh ac mi euismod, ac dapibus orci facilisis. ","url":"http:\/\/coupon.overplace.com\/consulente-di-innovazione-fabio-furiani","days_available":"15","date":"2013-09-06 14:20:10","token":"E+tlHoM8BC5DnZ4co47bzoR+PL0xpUEN1tf4IaAWD+I="} |
Metodo 2
couponGet
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].
- id_coupon : Id del coupon richiesto, ottenibile dal metodo couponRead(int)
- date_coupon: Data di creazione dell’offerta coupon, ottenibile dal metodo couponRead(string)
- token_coupon: Stringa criptata identificativa del coupon, ottenibile dal metodo couponRead(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 11 12 13 14 |
<?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> <ns3061:couponGet xmlns:ns3061="http://tempuri.org"> <ws_auth_token xsi:type="xsd:string">KVIkf6dbzuFyyqAzcXVZ50QIzo0p+U23BMEpjt4NyNM=</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> <id_coupon xsi:type="xsd:int">111</id_coupon> <date_coupon xsi:type="xsd:string">2013-09-10 10:49:13</date_coupon> <token_coupon xsi:type="xsd:string">ola5RvENG2mkqqUaRs0UoEUQik6zK90cEPeacfr/2Ww=</token_coupon> <response_type xsi:type="xsd:string">json</response_type> </ns3061:couponGet> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
Esempio Response lato Client
|
1 2 3 4 5 6 |
<response> <type>success</type> <code>1H2 M94 A33</code> <message>Abbiamo inviato una email alla tua casella di posta. Segui le istruzioni per usufruire del coupon.</message> [print_link] </response> |
Response in formato Json
|
1 |
{"type":"success","code":"LNE NTA 33","message":"Abbiamo inviato una email alla tua casella di posta. Segui le istruzioni per usufruire del coupon."} |