Validate
The following page is kept as a reference only. If you start a new project, please consider using Validate method in Web API 3 instead.
Please log in to get a personalized configuration!
All keys that are stored in a product that is public can be validated using the Web API. Key validation, in contrast to key activation is read only, ie. it only checks whether a key exists in the database and isn't blocked, but doesn't change the list of activated machines, etc. Information that is retrieved can be signed by the server to be able to keep validate keys without internet connection. All results are in JSON.
This method is accessed by https://serialkeymanager.com/Ext/Validate
Parameters
| Parameter | Description | Remarks |
| uid | the user id | required |
| pid | the product id | required |
| hsum | the control value | required |
| sid | the serial key string | required |
| sign | if set to true, a digital signature of the returned data will be included. | optional. by default, it's "false" |
| signPid | if set to true, the pid parameter will be returned. | optional. by default, it's "false" |
| signUid | if set to true, the uid parameter will be returned. | optional. by default, it's "false" |
| signDate | if set to true, the activation date will be returned. | optional. by default, it's "false" |
| signCustomer | if set to true, the activation date will be returned. | optional. by default, it's "false" |
Results
| Parameter | Description | Remarks |
| valid | always true if no error was thrown. | always returned |
| created | the creation date | always returned |
| expires | the expiration date | always returned |
| settime | the set time (30 days) | always returned |
| timeleft | the time left | always returned |
| f1 | feature 1 (either true or false) | always returned |
| f2 | feature 2 (either true or false) | always returned |
| f3 | feature 3 (either true or false) | always returned |
| f4 | feature 4 (either true or false) | always returned |
| f5 | feature 5 (either true or false) | always returned |
| f6 | feature 6 (either true or false) | always returned |
| f7 | feature 7 (either true or false) | always returned |
| f8 | feature 8 (either true or false) | always returned |
| notes | the notes field | returned if access to the notes field is enabled |
| signature | a digital signature (RSA 2048) | returned if sign=true and if a private has been generated |
| pid | the pid parameter (the same value as the input parameter pid) | returned if signPid is set to true. |
| uid | the uid parameter (the same value as the input parameter uid) | returned if signUid is set to true. |
| date | the activation date | returned if signDate is set to true. |
| customer | the id of the customer that this key is assigned to. | returned if signCustomer is set to true. |
Example results
{"valid":"true","created":"2014-11-30","expires":"2014-11-30","settime":"0","timeleft":"-5","f1":"False","f2":"False","f3":"False","f4":"False","f5":"False","f6":"False","f7":"False","f8":"False"}
{"valid":"true","created":"2014-11-30","expires":"2014-11-30","settime":"0","timeleft":"-5","f1":"False","f2":"False","f3":"False","f4":"False","f5":"False","f6":"False","f7":"False","f8":"False","signature":"QqVNu6yzMdIm6SHU50E+3cpnmNDwVb6qmFjDte3mr2JB5VNiJaZniVsIHtlBf0HexmKGRUq+Sxk6W0BSGsxOFMlDYWaYRJfTEwKJ4fdYzjQ8LqfWumXNMXJkOKkaF1CUYha8ucIj7TiNpR7hMtz+FcRqwoMfr2vqNo4qOGOm3BYu7syqFGPR4jzZ5Uoa3PR76BukxdLmuCUn33X+mvhFZquR7z0POWdp6T3G3+g8dhqIq5mnh2MIWFFCiG5gZV1x6eY0orIs4J//cOG5n7edRleKqz5aGU37n0xBuWv2YfR/uaWVEx8ktGIEdFAY1zNgBu01ZoHbOEyfp/pW4xlYzg=="}
Remarks
- If sign=false, while signMid, signPid, signUid, signDate are set to true, then mid, pid, uid and date will still be returned but will not be included into the signature.
- When the data is hashed (it is stored in signature), the following order is being used: valid, created,expires,settime,timeleft, f1, f2, f3, f4, f5, f6, f7, f8, notes, pid, uid, date, customer.
Errors
| Error |
| The hsum was incorrect. |
| The subscription level of the user does not allow this functionality. |
| Unable to access the given product. Either it does not exist or it is not set to be public. |
| Unable to access the key. Either, the key does not exist, it is blocked or was in incorrect format. |
Made in Sweden