Sensaphone.net API/history

Sensaphone.net API

Access

The History API allows access to the Audit Log and the Event Log

Specifications

The URI Mode for the History API is unique because it allows filtering options to be specified in pairs and can be added in any order. Also, the array values are expressed as a common-separated list.

 /history/audit_log/var_ids/{1234,9876}/changes/{create}

Audit Log

Something interesting about audit logs...

Audit Log Filter Options

Property	Status	Type	Description
var_ids	Optional	Array of Integer	list of variable ids
user_ids	Optional	Array of Integer	list of user ids
changes	Optional	Array of String	list of change types ("create","delete","update")
start	Optional	Integer	the start time (unix time)
end	Optional	Integer	the end time (unix time)
begin_offset	Optional	Integer	the beginning offset of the first record
record_offset	Optional	Integer	the offset from the beginning

GET

Audit Log Request Properties

Parent Property	Child Property	Type	Description
	acctid	Integer	Account ID
	session	String	Session ID
	request_type	String	"read"
	history	Object	The History object
history	audit_log	Object	Audit Log Filter Options

Audit Log Response Properties

Parent Property	Child Property	Type	Description
	history	Object	The history object
history	audit_log	Array of Objects	The returned log
audit_log	change	String	The change that occurred
audit_log	who	String	Who changed it
audit_log	what	String	What changed
audit_log	when	String	When it changed
history	audit_log_filter	Object	Audit Log Filter Options (Only returned in V2)

• Receive all "Unacknowledged Alarms" changes:

 GET https://rest.sensaphone.net/api/v1/{ACCOUNT}/{SESSION}/history/audit_log/var_ids/{217744}