Last Modified January 26, 2021
  1. Home
  2. RESTful API
  3. Licenses Password

Licenses Password

  1. API Request
  2. API Response
  3. Request Examples
  4. Response Examples

 

Use the Licenses Password API's to allow the following:

  • for Single-User Licenses:
    • update the License Password
  • for Multi-User and Floating Licenses:
    • update the License Password
    • set the License Admin Password used by the License Administrator to manage the License on behalf of all the users of the License - this requires a <License Key> sent to the User on the initial activation of a Multi-User or Floating License.
    • update the License Admin Password

When the Password Recovery process is initiated:

  • a Password Reset Code is generated and:
    • if SendDnaEmail=true, software_DNA sends a Custom Email to the <Activation Email> with the Password Reset Code
    • if SendDnaEmail=false, the Password Reset Code is included in the API Response for you to communicate to the End-User, and no email will be sent by software_DNA
  • the End-User can then provide the Password Reset Code and a <New Password> and update their password

HTTP Verb Element Syntax
POST URL https://api.softworkz.com/v1/Licenses/<productId>/<licenseId>/password
Body 
{
    "LicensePassword":"<password>",
    "NewPassword":"<newpassword>",
    "UserIp":"<userIp>",
    "Test":<Test>,
    "SendDnaEmail":<SendDnaEmail>
}

Updates the License Password if the <password> is the current License Password or the Password Reset Code

You must provide the End User IP Address. The IP Address is used to protect your implementation and this API from abuse and is only used to manage the IP Lockout feature of this API. The IP Lockout will be triggered after multiple invalid attempts in a given period, and a set cooling period will be enacted. Both are system-wide settings.
POST URL https://api.softworkz.com/v1/Licenses/<productId>/<licenseId>/adminpassword
Body 
{
    "AdminPassword":"<adminpassword>",
    "NewAdminPassword":"<newadminpassword>",
    "UserIp":"<userIp>",
    "Test":<Test>,
    "SendDnaEmail":<SendDnaEmail>
}

Updates the License Admin Password if the <password> is the current License Admin Password or the Admin Password Reset Code

You must provide the End User IP Address. The IP Address is used to protect your implementation and this API from abuse and is only used to manage the IP Lockout feature of this API. The IP Lockout will be triggered after multiple invalid attempts in a given period, and a set cooling period will be enacted. Both are system-wide settings.
POST URL https://api.softworkz.com/v1/Licenses/<productId>/<licenseId>/adminpassword
Body 
{
    "LicenseKey":"<licensekey>",
    "NewAdminPassword":"<newadminpassword>",
    "UserIp":"<userIp>",
    "Test":<Test>,
    "SendDnaEmail":<SendDnaEmail>
}

Sets the License Admin Password if the <licensekey> is correct. The License Key is sent to the <Activation Email> on the initial activation of a Multi-User of Floating License

You must provide the End User IP Address. The IP Address is used to protect your implementation and this API from abuse and is only used to manage the IP Lockout feature of this API. The IP Lockout will be triggered after multiple invalid attempts in a given period, and a set cooling period will be enacted. Both are system-wide settings.

Where:

Parameter Type Value Required Default
<productId> string the DNA ProductID Yes  
<licenseId> string the License Activation Code Yes  
<password> string the current License password or the Password Reset Code -  
<newpassword> string the new License Password -  
<adminpassword> string the current License Admin password or the Admin Password Reset Code -  
<newadminpassword> string the new License Password -  
<licensekey> string the License Key received by email on the initial activation -  
<userIp> string the User's IP Address, for protection against end-user abuse Yes  
<Test> bool if true, this is a Test Event No false
<SendDnaEmail> bool if true, software_DNA will send Custom Emails to the old and new Email addresses to notify User of the change to the License Email No true

 

API Response

Success HTTP Status Code Description
204 No Content The License Password or License Admin Password was updated.
Error HTTP Status Code Description
400 Bad Request one of the parameters was invalid or missing - check error message in Response for details
401 Unauthorized Basic Authentication failed - verify that you are using the correct <clientId> and <apiKey> information in the Basic Authentication Header
404 Not Found The <productId> and/or the <licenseId> was not found
409 Conflict A Test Event for an ACTIVE Product was received succesfully - but License not updated as Product is ACTIVE
429 Too Many Requests You have exceeded the allowed maximum of API Requests in the period - check "X-RateLimit-Reset" for the number of seconds remaining before reset
500 Internal Error An error occured on the DNA Server - try again later. Tech Support has been notified

 

Examples of API Requests

POST Licenses Password example

curl -v -X POST https://api.softworkz.com/v1/licenses/<productId>/TEST12345/password
-H "Accept: application/json"
-u "<clientId>:<API Key>"
-d ’{"LicensePassword:"12345","NewPassword":"54321","UserIp":"0.0.0.0","SendDnaEmail":false}’

 

Example of API Response with Licenses Password

No response is provided in the body

 

Example of API Error Response

{
  "Message": "Invalid ProductId format"
}