Minor updates

VoxHash · UnCarnaval · ScarlettHelp · VoxHash · commit 2cf9d5da178f · 2026-04-05T15:07:50.000-04:00
Co-Authored-By: UnCarnaval &lt;100311079+UnCarnaval@users.noreply.github.com&gt;
Co-Authored-By: Scarlett &lt;269428575+ScarlettHelp@users.noreply.github.com&gt;
diff --git a/README.md b/README.md
@@ -166,7 +166,7 @@ await client.start_webhook_listener()
 
 ## 📚 API Endpoints
 
-All endpoints automatically use the `/v1` prefix when connecting to `https://api.licensechain.app`.
+Use the canonical API base URL `https://api.licensechain.app/v1`. The SDK also accepts the root host and normalizes requests to the same API version.
 
 ### Base URL
 - **Production**: `https://api.licensechain.app/v1`
@@ -187,7 +187,7 @@ All endpoints automatically use the `/v1` prefix when connecting to `https://api
 | `POST` | `/v1/webhooks` | Create webhook |
 | `GET` | `/v1/analytics` | Get analytics |
 
-**Note**: The SDK automatically prepends `/v1` to all endpoints, so you only need to specify the path (e.g., `/auth/login` instead of `/v1/auth/login`).
+**Note**: The SDK accepts either the root host or the canonical `/v1` base and normalizes endpoint requests automatically.
 
 ## 📚 API Reference
 
@@ -200,7 +200,7 @@ config = LicenseChainConfig(
     api_key="your-api-key",
     app_name="your-app-name",
     version="1.0.0",
-    base_url="https://api.licensechain.app"  # Optional
+    base_url="https://api.licensechain.app/v1"  # Optional
 )
 
 client = LicenseChainClient(config)
@@ -417,7 +417,7 @@ export LICENSECHAIN_APP_NAME=your-app-name
 export LICENSECHAIN_APP_VERSION=1.0.0
 
 # Optional
-export LICENSECHAIN_BASE_URL=https://api.licensechain.app
+export LICENSECHAIN_BASE_URL=https://api.licensechain.app/v1
 export LICENSECHAIN_DEBUG=true
 ```
 
@@ -428,7 +428,7 @@ config = LicenseChainConfig(
     api_key="your-api-key",
     app_name="your-app-name",
     version="1.0.0",
-    base_url="https://api.licensechain.app",
+    base_url="https://api.licensechain.app/v1",
     timeout=30,        # Request timeout in seconds
     retries=3,         # Number of retry attempts
     debug=False,       # Enable debug logging
@@ -1018,7 +1018,7 @@ except LicenseChainException as e:
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
 | `api_key` | str | Required | Your LicenseChain API key |
-| `base_url` | str | `https://api.licensechain.app` | API base URL |
+| `base_url` | str | `https://api.licensechain.app/v1` | API base URL |
 | `timeout` | int | 30 | Request timeout in seconds |
 | `retry_attempts` | int | 3 | Number of retry attempts |
 | `retry_delay` | float | 1.0 | Delay between retries in seconds |
diff --git a/examples/advanced_analytics.py b/examples/advanced_analytics.py
@@ -25,7 +25,7 @@ async def main():
     api_key = os.getenv('LICENSECHAIN_API_KEY', 'your-api-key-here')
     client = LicenseChainClient(
         api_key=api_key,
-        base_url='https://api.licensechain.app',
+        base_url='https://api.licensechain.app/v1',
         timeout=30,
         retry_attempts=3,
     )
diff --git a/examples/basic_analytics.py b/examples/basic_analytics.py
@@ -25,7 +25,7 @@ async def main():
     api_key = os.getenv('LICENSECHAIN_API_KEY', 'your-api-key-here')
     client = LicenseChainClient(
         api_key=api_key,
-        base_url='https://api.licensechain.app',
+        base_url='https://api.licensechain.app/v1',
         timeout=30,
         retry_attempts=3,
     )
diff --git a/examples/basic_usage.py b/examples/basic_usage.py
@@ -33,7 +33,7 @@ def main():
     # Initialize the client
     client = Client(
         api_key='your-api-key-here',
-        base_url='https://api.licensechain.app',
+        base_url='https://api.licensechain.app/v1',
         timeout=30,
         retries=3
     )
diff --git a/examples/licenses_comprehensive.py b/examples/licenses_comprehensive.py
@@ -25,7 +25,7 @@ async def main():
     api_key = os.getenv('LICENSECHAIN_API_KEY', 'your-api-key-here')
     client = LicenseChainClient(
         api_key=api_key,
-        base_url='https://api.licensechain.app',
+        base_url='https://api.licensechain.app/v1',
         timeout=30,
         retry_attempts=3,
     )
diff --git a/examples/products_example.py b/examples/products_example.py
@@ -24,7 +24,7 @@ async def main():
     api_key = os.getenv('LICENSECHAIN_API_KEY', 'your-api-key-here')
     client = LicenseChainClient(
         api_key=api_key,
-        base_url='https://api.licensechain.app',
+        base_url='https://api.licensechain.app/v1',
         timeout=30,
         retry_attempts=3,
     )
diff --git a/examples/secure_integration.py b/examples/secure_integration.py
@@ -54,7 +54,7 @@ def __init__(
         api_key: str,
         license_key: str,
         app_id: Optional[str] = None,
-        base_url: str = "https://api.licensechain.app",
+        base_url: str = "https://api.licensechain.app/v1",
         validation_interval: int = 300,  # Re-validate every 5 minutes
     ):
         """
diff --git a/examples/teams_example.py b/examples/teams_example.py
@@ -24,7 +24,7 @@ async def main():
     api_key = os.getenv('LICENSECHAIN_API_KEY', 'your-api-key-here')
     client = LicenseChainClient(
         api_key=api_key,
-        base_url='https://api.licensechain.app',
+        base_url='https://api.licensechain.app/v1',
         timeout=30,
         retry_attempts=3,
     )
diff --git a/examples/test_connection.py b/examples/test_connection.py
@@ -23,7 +23,7 @@
 )
 
 
-async def test_api_connection(api_key: str, base_url: str = "https://api.licensechain.app"):
+async def test_api_connection(api_key: str, base_url: str = "https://api.licensechain.app/v1"):
     """Test basic API connection."""
     print("🔍 Testing API Connection...")
     
diff --git a/examples/test_licenses.py b/examples/test_licenses.py
@@ -165,7 +165,7 @@ async def main():
     # Initialize client
     client = LicenseChainClient(
         api_key=api_key,
-        base_url="https://api.licensechain.app",
+        base_url="https://api.licensechain.app/v1",
         timeout=30,
     )
     
diff --git a/licensechain/api_client.py b/licensechain/api_client.py
@@ -2,7 +2,7 @@
 import json
 import time
 from typing import Any, Dict, List, Optional, Union
-from urllib.parse import urljoin, urlencode
+from urllib.parse import urlencode
 
 from .exceptions import (
     NetworkError, ApiError, ValidationError, AuthenticationError,
@@ -12,13 +12,16 @@
 from .utils import retry_with_backoff, json_serialize, json_deserialize
 
 
+CANONICAL_BASE_URL = "https://api.licensechain.app/v1"
+
+
 class ApiClient:
     """HTTP client for LicenseChain API."""
     
-    def __init__(self, api_key: str, base_url: str = 'https://api.licensechain.app', 
+    def __init__(self, api_key: str, base_url: str = CANONICAL_BASE_URL, 
                  timeout: int = 30, retries: int = 3):
         self.api_key = api_key
-        self.base_url = base_url.rstrip('/')
+        self.base_url = self._normalize_base_url(base_url)
         self.timeout = timeout
         self.retries = retries
         self.session = requests.Session()
@@ -55,14 +58,7 @@ def _make_request(self, method: str, endpoint: str,
                      data: Optional[Dict[str, Any]] = None, 
                      params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
         """Make HTTP request with retry logic."""
-        # Ensure endpoint starts with /v1 prefix
-        if not endpoint.startswith('/v1/'):
-            if endpoint.startswith('/'):
-                endpoint = f'/v1{endpoint}'
-            else:
-                endpoint = f'/v1/{endpoint}'
-        
-        url = urljoin(self.base_url, endpoint.lstrip('/'))
+        url = self._build_url(endpoint)
         
         try:
             if method.upper() == 'GET':
@@ -86,6 +82,22 @@ def _make_request(self, method: str, endpoint: str,
             raise NetworkError(f"Request error: {e}")
         except Exception as e:
             raise UnknownError(f"Unexpected error: {e}")
+
+    def _normalize_base_url(self, base_url: str) -> str:
+        base_url = (base_url or CANONICAL_BASE_URL).rstrip('/')
+        if base_url.endswith('/v1'):
+            return base_url
+        return f"{base_url}/v1"
+
+    def _build_url(self, endpoint: str) -> str:
+        base_has_v1 = self.base_url.endswith('/v1')
+        if endpoint.startswith('/v1/'):
+            normalized_endpoint = endpoint[3:] if base_has_v1 else endpoint
+        elif endpoint.startswith('/'):
+            normalized_endpoint = endpoint if base_has_v1 else f'/v1{endpoint}'
+        else:
+            normalized_endpoint = f'/{endpoint}' if base_has_v1 else f'/v1/{endpoint}'
+        return f"{self.base_url}{normalized_endpoint}"
     
     def _handle_response(self, response: requests.Response) -> Dict[str, Any]:
         """Handle HTTP response."""
diff --git a/licensechain/client.py b/licensechain/client.py
@@ -30,7 +30,7 @@ class LicenseChainConfig(BaseModel):
     """Configuration for LicenseChain client."""
     
     api_key: str = Field(..., description="Your LicenseChain API key")
-    base_url: str = Field(default="https://api.licensechain.app", description="Base URL for the API")
+    base_url: str = Field(default="https://api.licensechain.app/v1", description="Base URL for the API")
     timeout: int = Field(default=30, description="Request timeout in seconds")
     retry_attempts: int = Field(default=3, description="Number of retry attempts")
     retry_delay: float = Field(default=1.0, description="Delay between retries in seconds")
@@ -47,7 +47,7 @@ class LicenseChainClient:
     def __init__(
         self,
         api_key: str,
-        base_url: str = "https://api.licensechain.app",
+        base_url: str = "https://api.licensechain.app/v1",
         timeout: int = 30,
         retry_attempts: int = 3,
         retry_delay: float = 1.0,
diff --git a/licensechain/enhanced_client.py b/licensechain/enhanced_client.py
@@ -22,7 +22,7 @@ class EnhancedClient(LicenseChainClient):
     """
     
     def __init__(self, app_name: str, owner_id: str, app_secret: str, 
-                 base_url: str = "https://api.licensechain.app", 
+                 base_url: str = "https://api.licensechain.app/v1", 
                  timeout: int = 30, retries: int = 3):
         super().__init__(app_name, owner_id, app_secret, base_url, timeout, retries)
         self._session_id = None
diff --git a/licensechain/license_validator.py b/licensechain/license_validator.py
@@ -23,7 +23,7 @@ class LicenseValidator:
     def __init__(
         self,
         api_key: str,
-        base_url: str = "https://api.licensechain.app",
+        base_url: str = "https://api.licensechain.app/v1",
         timeout: int = 30,
         retry_attempts: int = 3,
         retry_delay: float = 1.0,
diff --git a/licensechain/simple_client.py b/licensechain/simple_client.py
@@ -8,7 +8,7 @@
 class Client:
     """Main client for LicenseChain API."""
     
-    def __init__(self, api_key: str, base_url: str = 'https://api.licensechain.app', 
+    def __init__(self, api_key: str, base_url: str = 'https://api.licensechain.app/v1', 
                  timeout: int = 30, retries: int = 3):
         if not api_key:
             raise ConfigurationError("API key is required")

Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,7 @@ async def main():`
`25`	`25`	`api_key = os.getenv('LICENSECHAIN_API_KEY', 'your-api-key-here')`
`26`	`26`	`client = LicenseChainClient(`
`27`	`27`	`api_key=api_key,`
`28`		`- base_url='https://api.licensechain.app',`
	`28`	`+ base_url='https://api.licensechain.app/v1',`
`29`	`29`	`timeout=30,`
`30`	`30`	`retry_attempts=3,`
`31`	`31`	`)`
Original file line number	Diff line number	Diff line change
`@@ -33,7 +33,7 @@ def main():`
`33`	`33`	`# Initialize the client`
`34`	`34`	`client = Client(`
`35`	`35`	`api_key='your-api-key-here',`
`36`		`- base_url='https://api.licensechain.app',`
	`36`	`+ base_url='https://api.licensechain.app/v1',`
`37`	`37`	`timeout=30,`
`38`	`38`	`retries=3`
`39`	`39`	`)`
Original file line number	Diff line number	Diff line change
`@@ -24,7 +24,7 @@ async def main():`
`24`	`24`	`api_key = os.getenv('LICENSECHAIN_API_KEY', 'your-api-key-here')`
`25`	`25`	`client = LicenseChainClient(`
`26`	`26`	`api_key=api_key,`
`27`		`- base_url='https://api.licensechain.app',`
	`27`	`+ base_url='https://api.licensechain.app/v1',`
`28`	`28`	`timeout=30,`
`29`	`29`	`retry_attempts=3,`
`30`	`30`	`)`
Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,7 @@`
`23`	`23`	`)`
`24`	`24`
`25`	`25`
`26`		`-async def test_api_connection(api_key: str, base_url: str = "https://api.licensechain.app"):`
	`26`	`+async def test_api_connection(api_key: str, base_url: str = "https://api.licensechain.app/v1"):`
`27`	`27`	`"""Test basic API connection."""`
`28`	`28`	`print("🔍 Testing API Connection...")`
`29`	`29`
Original file line number	Diff line number	Diff line change
`@@ -165,7 +165,7 @@ async def main():`
`165`	`165`	`# Initialize client`
`166`	`166`	`client = LicenseChainClient(`
`167`	`167`	`api_key=api_key,`
`168`		`- base_url="https://api.licensechain.app",`
	`168`	`+ base_url="https://api.licensechain.app/v1",`
`169`	`169`	`timeout=30,`
`170`	`170`	`)`
`171`	`171`