Reader
This interface is available only to the registered clients. To register send via internal mail a message to WMID 941977853154 (Technical support) containing short information about the project, web-site URL, IP address, from which requests will be sent, the goal and method how the interface will be used. The Keeper signing the requests must have a personal passport (requests are processed up to three working days).
<w3s.request> <reqn></reqn> <wmid></wmid> <sign></sign> <message> <receiverwmid></receiverwmid> <msgsubj></msgsubj> <msgtext></msgtext> </message> </w3s.request>
| name | purpose | comments |
| reqn | request number | an integer without delimiter, max number of digits – 15; the value must always be greater than the number of previous request!!! |
| wmid | WMID of the user who signed the request | used only when authorizing WM Keeper Classic keys |
| sign | request signature – is formed using the following parameters: receiverwmid+reqn+msgtext+msgsubj | used only when authorizing WM Keeper Classic keys |
| message | parameters of sent message | |
| message\receiverwmid | WM identifier of message recepient | 12 digits |
| message\msgsubj | message text | random string from 1 to 255 characters; white spaces in the beginning or end and string feeds are not allowed |
| message\msgtext | message text | random string from 1 to 1024 characters; white spaces in the beginning or end are not allowed; use ‘\n’(\x10, chr(10)) for string feed |
In case there are tags in message text or message subject then you must include the contents of the corresponding request elements into the CDATA section: <![CDATA[your_text]]>.
<w3s.response> <reqn></reqn> <retval></retval> <retdesc></retdesc> <message id="n1"> <receiverwmid></receiverwmid> <msgsubj></msgsubj> <msgtext></msgtext> <datecrt></datecrt> </message> </w3s.response>
| name | purpose | comments |
| reqn | request number | |
| retval | request processing code | 0 – request successful |
| retdesc | description of request processing code | |
| message | parameters of sent message | id attribute – unique message number in WebMoney registration system |
| message\receiverwmid | WM identifier of message receiver | 12 digits |
| message\msgsubj | message subject | |
| message\msgtext | message text | |
| message\datecrt | date and time of message delivery | format YYYYMMDD HH:MM:SS |
| code | description |
| -2 | wrong value of message field\receiverwmid |
| -12 | Signature is invalid |
| 102 | The condition of constant increase of parameter value is not met w3s.request/reqn |
See also: XML-interfaces
Category: XML-Interfaces
This article in other languages: Русский