feat: no key provided class

src/fr24sdk/__init__.py

@@ -13,6 +13,7 @@
     TransportError,
     ApiError,
     AuthenticationError,
+    NoApiKeyError,
     RateLimitError,
     PaymentRequiredError,
     BadRequestError,
@@ -26,6 +27,7 @@
     "TransportError",
     "ApiError",
     "AuthenticationError",
+    "NoApiKeyError",
     "RateLimitError",
     "PaymentRequiredError",
     "BadRequestError",

src/fr24sdk/exceptions.py

@@ -66,6 +66,21 @@ class AuthenticationError(ApiError):
     pass
 
 
+class NoApiKeyError(Fr24SdkError):
+    """Indicates that no API key was provided for authentication.
+
+    This is a specific type of authentication error that occurs when the SDK
+    is used without providing an API token, either through the constructor
+    or the FR24_API_TOKEN environment variable.
+
+    Unlike other ApiError subclasses, this error is raised before any HTTP
+    request is made, so it doesn't include request/response context.
+    """
+
+    def __init__(self, message: str):
+        super().__init__(message)
+
+
 class RateLimitError(ApiError):
     """Indicates that the API rate limit has been exceeded (402 Payment Required or 429 Too Many Requests)."""
 

src/fr24sdk/transport.py

@@ -12,6 +12,7 @@
 from .exceptions import (
     ApiError,
     AuthenticationError,
+    NoApiKeyError,
     RateLimitError,
     TransportError,
     PaymentRequiredError,
@@ -73,6 +74,14 @@ def request(
     ) -> httpx.Response:
         """Makes an HTTP request to the API."""
 
+        # Check if API token is available before making the request
+        if not self.api_token:
+            raise NoApiKeyError(
+                "No API key provided. Please set the FR24_API_TOKEN environment variable "
+                "or pass an api_token parameter when creating the Client. "
+                "For more information, see https://fr24api.flightradar24.com/docs"
+            )
+
         request_headers = self._get_default_headers()
         if headers:
             request_headers.update(headers)