">
Resources - Digiprove's 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:
  • Parse and validate XML; if valid, proceed to
  • Update user details on Digiprove member register
  • Send confirmation email to user of changes
  • Send back a response in an XML envelope in the format defined below
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)
Test Drive the Technology What is Digiprove? Do I need it?