checkPassword

An operation checkPassword allows you to verify that a password is correct for the logged in user. It returns SUCCESS if the password is correct.

Example SOAP request:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:ns="ns1">
 <SOAP-ENV:Body  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <ns:checkPassword>
   <billonUserPassword>Haslo123</billonUserPassword>
  </ns:checkPassword>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example SOAP response:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:ns="ns1">
 <SOAP-ENV:Body  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <ns:checkPasswordResponse>
   <return>
    <requestStatus>SUCCESS</requestStatus>
    <requestStatusDescription>Request succeeded.</requestStatusDescription>
   </return>
  </ns:checkPasswordResponse>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Reequest parameters:

Parameter	Type	Description	Required?
billonUserPassword	string	the password of the current logged-on user	Yes

Request response:

Name	Type	Description
requestStatusDescription	string	a description of a status
requestStatus	string	result of request

Possible errors:

Error	Description
ERR_INVALID_PASSWORD	invalid password

How can we help?