Adding api-calls endpoint

Author: apetenchea

arango/database.py

@@ -44,6 +44,7 @@
     PermissionListError,
     PermissionResetError,
     PermissionUpdateError,
+    ServerAPICallsError,
     ServerAvailableOptionsGetError,
     ServerCheckAvailabilityError,
     ServerCurrentOptionsGetError,
@@ -463,6 +464,26 @@ def response_handler(resp: Response) -> Json:
 
         return self._execute(request, response_handler)
 
+    def api_calls(self) -> Result[Json]:
+        """Return recent API calls.
+
+        :return: API calls history.
+        :rtype: dict
+        :raise arango.exceptions.ServerAPICallsError: If retrieval fails.
+        """
+        request = Request(
+            method="get",
+            endpoint="/_admin/server/api-calls",
+        )
+
+        def response_handler(resp: Response) -> Json:
+            if not resp.is_success:
+                raise ServerAPICallsError(resp, request)
+            res: Json = resp.body["result"]
+            return res
+
+        return self._execute(request, response_handler)
+
     def status(self) -> Result[Json]:
         """Return ArangoDB server status.
 

arango/exceptions.py

@@ -642,6 +642,10 @@ class ServerDetailsError(ArangoServerError):
     """Failed to retrieve server details."""
 
 
+class ServerAPICallsError(ArangoServerError):
+    """Failed to retrieve recent API calls."""
+
+
 class ServerLicenseGetError(ArangoServerError):
     """Failed to retrieve server license."""
 

tests/test_database.py

@@ -20,6 +20,7 @@
     DatabaseListError,
     DatabasePropertiesError,
     DatabaseSupportInfoError,
+    ServerAPICallsError,
     ServerCheckAvailabilityError,
     ServerDetailsError,
     ServerEchoError,
@@ -314,6 +315,12 @@ def test_database_misc_methods(client, sys_db, db, bad_db, cluster, secret, db_v
         with assert_raises(ServerLogLevelResetError):
             bad_db.reset_log_levels()
 
+    # Test api calls history
+    with assert_raises(ServerAPICallsError):
+        bad_db.api_calls()
+    history = sys_db.api_calls()
+    assert isinstance(history, dict)
+
     # Test get storage engine
     engine = db.engine()
     assert engine["name"] in ["rocksdb"]