Интерфейс X6

Интерфейс X6. Отправка сообщения произвольному WM-идентификатору по внутренней почте.

Этот интерфейс доступен только зарегистрированным клиентам. Для регистрации перешлите по внутренней почте на WMID 941977853154 (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).

<w3s.request>
	<reqn></reqn>
	<wmid></wmid>
	<sign></sign>
	<message>
		<receiverwmid></receiverwmid>
		<msgsubj></msgsubj>
		<msgtext></msgtext>
	</message>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр – 15; всегда должен быть больше номера предыдущего запроса!!!
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper Classic
sign подпись запроса – формируется из параметров: receiverwmid+reqn+msgtext+msgsubj используется только при авторизации с ключами WM Keeper Classic
message параметры передаваемого сообщения
message\receiverwmid WM-идентификатор получателя сообщения 12 цифр
message\msgsubj тема сообщения произвольная строка от 1 до 255 символов; пробелы в начале или конце и переводы строк не допускаются
message\msgtext текст сообщения произвольная строка от 1 до 1024 символов; пробелы в начале или конце не допускаются; для перевода строки используйте ‘\n’ (\x10, chr(10))

В случае, если в тексте сообщения или теме сообщения содержатся теги, содержимое соответствующих элементов запроса необходимо заключать в секцию CDATA: <![CDATA[ваш_текст]]>.

  • формат ответа:
<w3s.response>
	<reqn></reqn>
	<retval></retval>
	<retdesc></retdesc>
	<message id="">
		<receiverwmid></receiverwmid>
		<msgsubj></msgsubj>
		<msgtext></msgtext>
		<datecrt>ГГГГММДД ЧЧ:ММ:СС</datecrt>
	</message>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса  
retval код выполнения запроса 0 – запрос выполнен
retdesc расшифровка кода выполнения запроса  
message параметры переданного сообщения атрибут id – уникальный номер сообщения в системе учета WebMoney
message\receiverwmid WM-идентификатор получателя сообщения 12 цифр
message\msgsubj тема сообщения  
message\msgtext текст сообщения  
message\datecrt дата и время передачи сообщения формат ГГГГММДД ЧЧ:ММ:СС
  • специфичные для интерфейса ошибки (retval):
код описание
-2 Неверное значение поля message\receiverwmid
-12 Подпись не верна
102 Не выполнено условие постоянного увеличения значения параметра w3s.request/reqn

см. также XML-интерфейсы

Категория: XML-интерфейсы

This article in other languages: English