From e1c4345d1e0ee45006578e71ce09c4a1b742bc48 Mon Sep 17 00:00:00 2001
From: Julian Daube <julian.daube@ic4x.com>
Date: Wed, 6 Mar 2024 10:51:43 +0100
Subject: [PATCH] add getClientHistory() call to fetch history of client
 interactions

---
 omada/omada.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/omada/omada.py b/omada/omada.py
index 987cb08..80e3afa 100644
--- a/omada/omada.py
+++ b/omada/omada.py
@@ -518,3 +518,19 @@ def getWirelessGroups(self, site=None):
 	##
 	def getWirelessNetworks(self, group, site=None):
 		return self.__get( f'/sites/{self.__findKey(site)}/setting/wlans/{group}/ssids' )
+
+	##
+	## Returns client history based on clients mac adress
+	##
+	## Function does not validate mac address, use getSiteClients() to find clients of interest.
+	## timeStart and timeEnd are in unix timestamps (type int)
+	##
+	def getClientHistory(self, clientmac, site=None, timeStart = None, timeEnd = None):
+		params = dict()
+
+		if timeStart is not None:
+			params["filters.timeStart"] = int(timeStart)
+		if timeEnd is not None:
+			params["filters.timeEnd"] = int(timeEnd)
+
+		return self.__geterator(f"/sites/{self.__findKey(site)}/clientHistory/{clientmac}", params=params)
\ No newline at end of file