admin/logs/traces/range

Wordbee logs changes, deletions and insertions of business objects down to field level. This covers changes to orders, projects, jobs, companies, prices, etc. These business objects are tracked are listed here.

This method returns the traces between a start and and an end date.

This method will be released on May 23 2018.

URL

(GET) /admin/logs/traces/range?from=&to=skip=&take=

PARAMETERS

The URL parameters are:

from	The date range start. Example: 2018-05-10T09:00:00Z Specify dates as UTC (Z-indicator) or with the timezone offset.	datetime, Mandatory
to	The date range end. The maximum allowed period between "from" to "to" is 48 hours.	datetime, Mandatory
skip	Optional. Used for pagination. The number of events to skip. Value is 0 by default.	int?, Optional
take	Optional. Used for pagination. The number of events to retrieve. Value is 1000 by default. The maximum value is 10000.	int?, Optional

Note, if you are logging a large amount of events, please make sure to use pagination properties skip and take.

Example:

/api/admin/logs/traces/range?start=2018-05-10T10:00:00Z&end=2018-05-10T15:00:00Z&skip=0&take=100

RESULTS

The result is a JSON object with these properties:

rows	An array of trace events. See details here: Trace details	datetime
skip	The skip parameter value.	int
take	The take parameter value.	int
hasmore	True if there are more results. To fetch the next set of results, call the method again with skip/take set accordingly. Example: First batch: ?skip=0&take=1000 Second batch: ?skip=1000&take=1000 etc.	bool

EXAMPLE

A few lines of a log file:

{
	"rows": [{
		"v": 1,
		"a": "i",
		"oc": "ps",
		"key": {
			"uid": 138
		},
		"dt": "2017-07-10T16:18:53.6961066Z",
		"uid": 1,
		"cid": 1,
		"ts": "0ec12110-50c9-4c60-927e-3a250eea5ccf",
		"tsc": "new account",
		"flds": [{
			"f": "RssNotifications",
			"v": "Personal"
		},
		{
			"f": "EmailNotifications",
			"v": "Personal"
		},
		{
			"f": "NotifyOrders",
			"v": "Personal"
		},
		{
			"f": "NotifyJobs",
			"v": "Personal"
		},
		{
			"f": "PersonId",
			"v": "0"
		},
		{
			"f": "AddressId",
			"v": "1"
		},
		{
			"f": "FirstName",
			"v": "creation"
		},
		{
			"f": "LastName",
			"v": "test"
		},
		{
			"f": "Email",
			"v": "cpons@wordbee.com"
		},
		{
			"f": "PersonCode",
			"v": "ct"
		},
		{
			"f": "RssNotifications_",
			"v": "1"
		},
		{
			"f": "EmailNotifications_",
			"v": "1"
		},
		{
			"f": "IsActive",
			"v": "False"
		},
		{
			"f": "LoginAttempts",
			"v": "0"
		},
		{
			"f": "Password",
			"v": "*****"
		},
		{
			"f": "PwdDate",
			"v": "10/07/2017 16:18:51"
		},
		{
			"f": "NotifyOrders_",
			"v": "0"
		},
		{
			"f": "NotifyJobs_",
			"v": "0"
		}]
	},
	{
		"v": 1,
		"a": "c",
		"oc": "ps",
		"key": {
			"uid": 138
		},
		"dt": "2017-07-10T16:19:36.6244773Z",
		"ts": "79a5aa40-b302-44ff-baaf-71d88b4c67fd",
		"flds": [{
			"f": "PersonCode",
			"v": "cao",
			"p": "ct"
		}]
	},
	{
		"v": 1,
		"a": "d",
		"oc": "ps",
		"key": {
			"uid": 138
		},
		"dt": "2017-07-10T16:19:46.7389286Z",
		"ts": "313b163f-211c-41d4-bd0e-35496b560fe8",
		"tsc": "Delete",
		"flds": []
	}],
	"skip": 0,
	"take": 1000,
	"hasmore": false
}