(20241125) Documentation added.

api/blueprints/mail/callback.py

@@ -112,7 +112,7 @@ def init(blueprint_setup_state):
     attr_name = "logs_mongo",
     project = constants.PROJECT_NAME,
     log_type = constants.MODULE_NAME,
-    operation = "testCllBckApi",
+    operation = "gmailCllBckApi",
     log_input = True,
     log_output = True,
     sensitive_keys = None
@@ -120,7 +120,7 @@ def init(blueprint_setup_state):
 @log_chain_to_mongo(attr_name = "logs_mongo")
 @should_not_be_under_maintenance(attr_name = "is_under_maintenance")
 @handle_cancelled_request()
-async def callback_test(
+async def mail_callback(
         inbound_headers: dict = None,
         inbound_data: dict = None,
         inbound_files: dict = None,
@@ -128,7 +128,7 @@ async def callback_test(
 ):
 
     """
-    This URL does nothing, just captures data on webhooks and logs it for documentation.
+    Use this when authorizing access to someone's GMail account. This can be used to capture the authentication token.
     :param inbound_headers: auto-extracted by the decorators.
     :param inbound_data: auto-extracted by the decorators.
     :param inbound_files: auto-extracted by the decorators.