Digiprove API - Update User

Submitting a Request to change user details

The user information should be encapsulated in an XML message along with user credentials. The message will be in the following format:

<digiprove_update_user>
<user_agent>xxxxxxxxxxxxxxxx</user_agent>	string identifying the originating software and system
<user_id>xxxxxxxxxxxxxxxx</user_id>	Mandatory: string max 40 - note this is usually the user's email address
<password>xxxxxxxxxxxxxx</password>	Either this or api_key/domain pair must be submitted. Minimum 6 characters
<domain_name>xxxxxxxxxxxxxx</domain_name>	Name of domain matching the API key submitted, or for which a new API key requested
<api_key>xxxxxxxxxxxxxx</api_key>	API key corresponding to domain
<request_api_key>Yes</request_api_key>	Request a new API key for domain_name above - password must be supplied
<email_address>xxxxxxxxxx</email_address>	New value for email address
<first_name>xxxxxxxxxxxxxx</firstname>	New value for first name
<last_name>xxxxxxxxxxxxxx</lastname>	New value for last name
<display_name>Xxx</display_name>	Yes or No - Whether name to be included on certificate display pages
<email_certs>Xxx</email_certs>	Yes or No - Whether content certificates should be emailed to user
<subscription_plan>xxxxxxxxxxxxxx</subscription_plan>	Reserved for future use
</digiprove_update_user>

Processing an Update User Request

This xml envelope is submitted to Digiprove's SOAP service, which will perform the following:

Format of Update User Response

<digiprove_register_user_response>
<result_code>999</result_code>	See below for values
<result>xxxxxxxxxxxxxxxx</result>	"Success" or error description
<api_key>xxxxxxxxxxxxxxxx</api_key>	Is supplied if a new API key was requested - unique key for messages from that domain for that user
<subscription_type>xxxxxxxxxxxxxxxx</subscription_type>	Subscription type as recorded on Digiprove database
</digiprove_register_user_response>

Result Codes

0 - Success
110 - Internal error
120 - XML validation error (as described in <result> tag)
130 - Other Error (as described in <result> tag)