Permalink: |
Counter bids list for current wmid
This api allows to receive information about new bids of the specific WMID.
- Requests using WM Keeper WinPro key authorization should be sent to https://wm.exchanger.ru/asp/XMLWMList3.asp for XML querys and https://wm.exchanger.ru/asp/JSONWMList3.asp for JSON querys
- Requests using WM Keeper WebPro certificate authorization should be sent to https://wmeng.exchanger.ru/asp/XMLWMList3.asp for XML querys and https://wmeng.exchanger.ru/asp/JSONWMList3.asp for JSON querys
- Method - POST
- XML Request format:
<?xml version=\"1.0\"?> <wm.exchanger.request> <wmid></wmid> <signstr></signstr> <type></type> <queryid></queryid> <capitallerwmid></capitallerwmid> </wm.exchanger.request>
- JSON Request format:
{ "wmid": "", "signstr": "", "queryid": "", "type": "", "pursetype_id": "", "capitallerwmid": "" }
- Request parameters:
name | purpose | comments |
wmid | Signer's WMID | WMID from which a new bid will be placed. |
signstr | Request signature. | 132-digits digital signature (by .kwm keys of the wmid) encoding the value of three tags of the request, pulled together in one line without spaces, "wmid + type + queryid" |
type | request type | reserved for future use. currently n/a |
queryid | optional field | id of the counter bid belonging to WMID , which data/details are to be returned; if the parameter is indicated as "-1", last 20 bids of this WMID are returned |
capitallerwmid | optional field | if Capitaller’s WMID is being transferred in this field (www.capitaller.ru) the exchange bid on behalf of capitallerwmid may be set under this request. In this case there must be an access for WMID which signs the request which is described at Capitaller’s Impersonalization page. |
- Response format:
<?xml version=\"1.0\"?> <wm.exchanger.response> <WMExchnagerQuerys wmid=""" type=""> ............... <query id="" isxid="" exchtype="" state="" amountin="" amountout="" inoutrate="" outinrate="" inpurse="" outpurse="" querydatecr="" querydate="" direction="" newtrid="" datesynchro=""></query> ............... </WMExchnagerQuerys> <retval></retval> <retdesc></retdesc> </wm.exchanger.response>
- Response parameters
Name | Purpose | Description |
retval | Execution code | "0" means that the request was executed successfully. Check the execution code table for detailed information; |
retdesc | Execution code description | error description in case retval tag is not 0 |
query | query information | infoamtion abount bid ◦ id attribute - number of the counter bid ◦ isxid attribute - number of the new bid as per the counter bid ◦ exchtype attribute - exchange direction, see interface # X1 ◦ state - current status ◾0 - bid not processed ◾1 - processed, exchange performed, funds not yet processed ◾2 - exchanged completely, funds processed ◾3 - exchange not processed, bid converted into the new bid for the same wmid(possible reasons: exchange couldn't have been performed for any reasons, rate of the new bid has changed or there were not enough funds to cover the counter bid) ◦ amountin attribute - amount in WM, exchanged in the specific counter bid ◦ amountout attribute - amount in WM received by WMID as per specific counter bid ◦ inoutrate attribute - direct exchange rate of the bid ◦ outinrate attribute - reverse exchange rate of the bid ◦ inpurse attribute - purse, from which the bid was processed ◦ outpurse attribute - purse to receive exchanged funds ◦ querydatecr attribute - bid application date ◦ querydate attribute - date of bid’s last change ◦ direction attribute - exchange direction ◦ newtrid attribute - if current counter bid was converted into the new (there were no purse payouts) so in current attribute the number of this bid |
capitallerwmid |
- Example
<?xml version=\"1.0\"?> <wm.exchanger.request> <wmid>500000000008</wmid> <signstr>bdeafd87baaffa660e6d359ffc2f76145aa3ac11b6075387eddb0c9fb6b96bf1b2cd3b6b16e67328b2bc7bef2fb21a9fbe9849381429c6b9e7a53bdb01b22b1e00eb</signstr> <type>1</type> <queryid>-1</queryid> <capitallerwmid>0</capitallerwmid> </wm.exchanger.request> <?xml version=\"1.0\"?> <wm.exchanger.response> <WMExchnagerQuerys wmid=\"500000000008\" type=\"1\"> <query id=\"1549440\" isxid=\"786527\" exchtype=\"1\" state=\"2\" amountin=\"55\" amountout=\"1377,79\" inoutrate=\"0,0399\" outinrate=\"25,0507\" inpurse=\"Z000000000006\" outpurse=\"R300000000006\" querydatecr=\"01.11.2007 15:39:35\" querydate=\"01.11.2007 15:39:42\" direction=\"WMZ-WME\" newtrid=\"0\" datesynchro=\"2007-11-01 15:39:42.420\"></query> </WMExchnagerQuerys> <retval>0</retval> <retdesc></retdesc> </wm.exchanger.response>