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.