">
Resources - Digiprove's API - Reserve a certificate url
Submitting a Digiprove Reserve Certificate URL Request
The message will be in the following XML format:
<digiprove_reservation_request>
<user_agent>xxxxxxxxxxxxxxxx</user_agent>string identifying the originating software and system
<user_id>xxxxxxxxxxxxxxxx</user_id>Mandatory: string max 40 characters - 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
</digiprove_reservation_request>
Processing a Digiprove Reserve Certificate Url Request
This xml envelope is submitted to Digiprove's SOAP service, which will perform the following:
  • Parse and validate XML; if valid, proceed to
  • Check user credentials
  • Formulate and reserve a unique short url on the Digiprove site
  • Send back a response in an XML envelope in the format defined below
Format of Digiprove Reserve Certificate Url Response
<digiprove_reservation_response>
<result_code>999</result_code>See below for values
<result>xxxxxxxxxxxxxxxx</result>"Success" or error description
<short_cert_url>xxxxxxxxxxxxxx</short_cert_url>
</digiprove_reservation_response>
Result Codes
0 - Success
100 - Web service error
101 - User id/password combination not found
102 - User id not activated
103 - User account closed
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?