Get Web API Log

This method will retrieve a list of Web API Logs. All events that get logged are related to a change of a license key or data object, eg. when license key gets activated or when a property of data object changes. More details about the method that was called are specified in the State field. You can read more about it here. These logs contain minimal information but are guaranteed to be preserved. To get more information, especially about changes not tracked in this log, please check out the Object Log. Note, it's possible to restrict access to this method so that it can be used inside a client application, more about this in remarks.

Parameters

This method is accessed by https://api.cryptolens.io/api/ai/GetWebAPILog

Parameter	Description	Remarks
ProductId	The product id that we should filter on.	optional
Key	The key string that we should filter on.	optional, but requires ProductId to be specified.
MachineCode	The machine code to filter on. Requires the entire machine code to be specified. Case sensitive.	optional
FriendlyName	The friendly name to filter on. "Contains" operation is used, i.e. you do not need to specify the entire friendly name. Case insensitive.	optional
States	The list of integer values representing the state that you want to filter on. This allows you to extract logs related to a certain event. For example, if you want to see all CreateKey request, you can set this parameter to [3010]. If you need to filter on multiple events, you can add them to the list as follows: [3010,2010]. You can read more about the different states here.	optional
Limit	Specifies how many events should be returned.	default is 10 and at most 1000
StartingAfter	Works as a cursor (for pagination). If the last element had the id=125, then setting this to 125 will return all events coming after 125.	optional
EndingBefore	Works as a cursor (for pagination). If the last element had the id=125, then setting this to 125 will return all events coming before 125.	optional
OrderBy	Allows you to order the data based on one of the fields in the Web API Log Objects. By default, it will order in "ascending" mode. To change that, you can append "descending" to the field. For example, to order by Id in a descending order, you can set this variable to Id descending.	optional
AnomalyClassification	If enabled, the result will contain information about whether a certain request is anomalous. You can read more about this feature here.	optional, false by default.
v	Method version.	optional. by default, it's 1.

Results

Parameter	Description	Remarks
Logs	A list of Web API Log Objects. If AnomalyClassification is set to true, a list of Web API Log Objects (extended) will be returned instead.	returned if no errors are thrown
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

{"result":0,"message":""}

Remarks

If you set KeyLock=-1 when creating the access token, this method will require the product id together with the license key string. This can be used to retrieve logs inside a client application without exposing logs of other license keys.

Errors

Error

Access denied.

The input parameters were incorrect.

An error occured.