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. |