Merge branch 'main_merge_20260416' into 'main'

feat: add configurable client source header for HTTP requests

See merge request webull/webull-openapi-python-sdk!20

Author: 方佳

samples/__init__.py

@@ -1 +1 @@
-__version__ = '2.0.2'
+__version__ = '2.0.3'

webull/__init__.py

@@ -1 +1 @@
-__version__ = '2.0.2'
+__version__ = '2.0.3'

webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '2.0.2'
+__version__ = '2.0.3'
 
 import logging
 

webull/core/client.py

@@ -41,6 +41,7 @@
 
 import json
 import logging
+import os
 import platform
 import time
 from logging.handlers import TimedRotatingFileHandler
@@ -69,6 +70,8 @@
 DEFAULT_CONNECTION_TIMEOUT = 5
 DEFAULT_PORT = 443
 DEFAULT_REGION_ID = "us"
+DEFAULT_CLIENT_SOURCE = "sdk"
+CLIENT_SOURCE_ENV = "WEBULL_CLIENT_SOURCE"
 
 logger = logging.getLogger(__name__)
 
@@ -254,6 +257,7 @@ def _make_http_response(self, endpoint, request, read_timeout, connect_timeout,
         headers['User-Agent'] = self._compose_ua(request)
         if self.get_token():
             headers['x-access-token'] = self.get_token()
+        headers[hd.CLIENT_SOURCE] = self._get_client_source()
 
         protocol = request.get_protocol_type()
         url = request.get_url()
@@ -270,6 +274,15 @@ def _make_http_response(self, endpoint, request, read_timeout, connect_timeout,
             verify=self.get_verify())
         response.set_content(body, "utf-8")
         return response
+
+    @staticmethod
+    def _get_client_source():
+        client_source = os.environ.get(CLIENT_SOURCE_ENV)
+        if client_source is not None:
+            client_source = client_source.strip()
+            if client_source:
+                return client_source
+        return DEFAULT_CLIENT_SOURCE
 
     def _implementation_of_do_action(self, request, signer=None):
         if not isinstance(request, BaseRequest):

webull/core/headers.py

@@ -40,6 +40,7 @@
 """
 
 REQUEST_ID = "X-Request-Id"
+CLIENT_SOURCE = "x-webull-client-source"
 APP_KEY = "x-app-key"
 SIGNATURE = "x-signature"
 SIGN_ALGORITHM = "x-signature-algorithm"
@@ -54,4 +55,4 @@
 NATIVE_HOST = "Host"
 NATIVE_CONTENT_TYPE = "Content-Type"
 NATIVE_CONTENT_LENGTH = "Content-Length"
-NATIVE_USER_AGENT = "User-Agent"
+NATIVE_USER_AGENT = "User-Agent"

webull/data/__init__.py

@@ -1,3 +1,3 @@
 # coding=utf-8
 
-__version__ = '2.0.2'
+__version__ = '2.0.3'

webull/trade/__init__.py

@@ -1 +1 @@
-__version__ = '2.0.2'
+__version__ = '2.0.3'