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 |