Key Lock
Please log in to get a personalized configuration!
This method will, given a license key, generate a new access token that is locked to that particular key and return the Id of that key. The scope of the access token is preserved (i.e. all methods that were enabled in the access token used to access this method will be copied to the new access token) except for the key lock, which is going to be changed to the id of the license key. Note, for this method to work, the access token used to access this method has to have key lock set to -1 or smaller. All of these details are described in Remarks.
This method is accessed by https://api.cryptolens.io/api/auth/KeyLock
Parameters
Parameter | Description | Remarks |
ProductId | the product id | required |
Key | the serial key string | required |
v | Method version. | optional. by default, it's 1. |
Results
Parameter | Description | Remarks |
KeyId | The id of the license key (i.e. not the key string). | always returned |
Token | The new Access Token. | always returned |
Result | This is either 0(=success) or 1(=error). | always returned |
Message | The message that provides additional information about the result. If it's a successful result, null will be returned. Otherwise, in case of an error, a short message will be returned describing the error. | always returned. |
Example results
{"keyId":1005,"token":"WyIxOCIsIldGQlkyOHhXV2wrQkJaQVNaanJFV1pHdzZwVzZJQTVNK3M0UlphMFkiXQ==","result":0,"message":null}
Remarks
- The access token has to have the Key Lock set to -1 or smaller for this method to work.
- This method does not require any explicit permission. If the Key Lock set to -1 or smaller this method will be enabled.
- The new access token will have the same permission on the methods. Only the Key Lock will be changed from being -1 to the KeyId of the given key (in the input parameters).
- The access token cannot be retrieved after generation. Please make sure to store it inside the app to avoid generating a new access token.
- The value of the KeyLock specifies the expiration date of the new access token, i.e. -1 will set the expiration to 1 day from the time the access token was generated. Similarly, setting it to -2 will set the expiration date 2 days from the time of the request.
Errors
Error |
The Key Lock has to be set to '-1' for this method to work. |
Could not find the product. |
Could not find the key. |