feat: Add telemetry headers for app tracking (v1.5.0)

- Add app_url and app_name config options for SDK telemetry
- Send X-SDK-Name, X-SDK-Version headers on every request
- Send X-App-URL, X-App-Name headers when configured (10% bonus!)
- Rename headers from X-Api-Client to X-SDK-Name for consistency
- Bump version to 1.5.0

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: karlwaldman

oilpriceapi/__init__.py

@@ -4,7 +4,7 @@
 The official Python SDK for OilPriceAPI - Real-time and historical oil prices.
 """
 
-__version__ = "1.4.2"
+__version__ = "1.5.0"
 __author__ = "OilPriceAPI"
 __email__ = "support@oilpriceapi.com"
 

oilpriceapi/async_client.py

@@ -61,6 +61,8 @@ def __init__(
         headers: Optional[Dict[str, str]] = None,
         max_connections: int = 100,
         max_keepalive_connections: int = 20,
+        app_url: Optional[str] = None,
+        app_name: Optional[str] = None,
     ):
         # Get API key
         self.api_key = api_key or os.environ.get("OILPRICEAPI_KEY")
@@ -76,6 +78,8 @@ def __init__(
         self.retry_on = retry_on or self.DEFAULT_RETRY_CODES
         self.max_connections = max_connections
         self.max_keepalive_connections = max_keepalive_connections
+        self.app_url = app_url
+        self.app_name = app_name
 
         # Initialize retry strategy
         self._retry_strategy = RetryStrategy(
@@ -84,15 +88,23 @@ def __init__(
         )
 
         # Build headers
+        import sys
+        python_version = f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
         self.headers = {
             "Authorization": f"Token {self.api_key}",
             "Content-Type": "application/json",
             "Accept": "application/json",
-            "User-Agent": "OilPriceAPI-Python-Async/1.4.0",
-            "X-SDK-Language": "python",
-            "X-SDK-Version": "1.4.0",
-            "X-Client-Type": "sdk",
+            "User-Agent": f"oilpriceapi-python/1.5.0 python/{python_version}",
+            "X-SDK-Name": "oilpriceapi-python",
+            "X-SDK-Version": "1.5.0",
         }
+
+        # Add optional telemetry headers (10% bonus for app_url!)
+        if self.app_url:
+            self.headers["X-App-URL"] = self.app_url
+        if self.app_name:
+            self.headers["X-App-Name"] = self.app_name
+
         if headers:
             self.headers.update(headers)
 

oilpriceapi/client.py

@@ -78,6 +78,8 @@ def __init__(
         max_retries: Optional[int] = None,
         retry_on: Optional[list] = None,
         headers: Optional[Dict[str, str]] = None,
+        app_url: Optional[str] = None,
+        app_name: Optional[str] = None,
     ):
         # Get API key from parameter or environment
         self.api_key = api_key or os.environ.get("OILPRICEAPI_KEY")
@@ -104,17 +106,28 @@ def __init__(
             f"timeout={self.timeout}s, max_retries={self.max_retries}"
         )
 
+        # Store telemetry settings
+        self.app_url = app_url
+        self.app_name = app_name
+
         # Build headers
         import sys
         python_version = f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
         self.headers = {
             "Authorization": f"Token {self.api_key}",
             "Content-Type": "application/json",
             "Accept": "application/json",
-            "User-Agent": f"oilpriceapi-python/1.4.2 python/{python_version}",
-            "X-Api-Client": "oilpriceapi-python",
-            "X-Client-Version": "1.4.2",
+            "User-Agent": f"oilpriceapi-python/1.5.0 python/{python_version}",
+            "X-SDK-Name": "oilpriceapi-python",
+            "X-SDK-Version": "1.5.0",
         }
+
+        # Add optional telemetry headers (10% bonus for app_url!)
+        if self.app_url:
+            self.headers["X-App-URL"] = self.app_url
+        if self.app_name:
+            self.headers["X-App-Name"] = self.app_name
+
         if headers:
             self.headers.update(headers)