Spaces:
Sleeping
Sleeping
File size: 4,199 Bytes
097eaf0 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | """
Error handling utilities for v2 API.
"""
import requests
from typing import Dict, Any, Optional
class FirecrawlError(Exception):
"""Base exception for Firecrawl API errors."""
def __init__(self, message: str, status_code: Optional[int] = None, response: Optional[requests.Response] = None):
super().__init__(message)
self.status_code = status_code
self.response = response
class BadRequestError(FirecrawlError):
"""Raised when the request is invalid (400)."""
pass
class UnauthorizedError(FirecrawlError):
"""Raised when the request is unauthorized (401)."""
pass
class PaymentRequiredError(FirecrawlError):
"""Raised when payment is required (402)."""
pass
class WebsiteNotSupportedError(FirecrawlError):
"""Raised when website is not supported (403)."""
pass
class RequestTimeoutError(FirecrawlError):
"""Raised when request times out (408)."""
pass
class RateLimitError(FirecrawlError):
"""Raised when the rate limit is exceeded (429)."""
pass
class InternalServerError(FirecrawlError):
"""Raised when there's an internal server error (500)."""
pass
def handle_response_error(response: requests.Response, action: str) -> None:
"""
Handle API response errors and raise appropriate exceptions.
Args:
response: The HTTP response object
action: Description of the action being performed
Raises:
FirecrawlError: Appropriate error based on status code
"""
try:
response_json = response.json()
error_message = response_json.get('error', 'No error message provided.')
error_details = response_json.get('details', 'No additional error details provided.')
except:
# If we can't parse JSON, provide a helpful error message
try:
response_text = response.text[:500] # Limit to first 500 chars
if response_text.strip():
error_message = f"Server returned non-JSON response: {response_text}"
error_details = f"Full response status: {response.status_code}"
else:
error_message = f"Server returned empty response with status {response.status_code}"
error_details = "No additional details available"
except:
error_message = f"Server returned unreadable response with status {response.status_code}"
error_details = "No additional details available"
# Create appropriate error message
if response.status_code == 400:
message = f"Bad Request: Failed to {action}. {error_message} - {error_details}"
raise BadRequestError(message, response.status_code, response)
elif response.status_code == 401:
message = f"Unauthorized: Failed to {action}. {error_message} - {error_details}"
raise UnauthorizedError(message, response.status_code, response)
elif response.status_code == 402:
message = f"Payment Required: Failed to {action}. {error_message} - {error_details}"
raise PaymentRequiredError(message, response.status_code, response)
elif response.status_code == 403:
message = f"Website Not Supported: Failed to {action}. {error_message} - {error_details}"
raise WebsiteNotSupportedError(message, response.status_code, response)
elif response.status_code == 408:
message = f"Request Timeout: Failed to {action} as the request timed out. {error_message} - {error_details}"
raise RequestTimeoutError(message, response.status_code, response)
elif response.status_code == 429:
message = f"Rate Limit Exceeded: Failed to {action}. {error_message} - {error_details}"
raise RateLimitError(message, response.status_code, response)
elif response.status_code == 500:
message = f"Internal Server Error: Failed to {action}. {error_message} - {error_details}"
raise InternalServerError(message, response.status_code, response)
else:
message = f"Unexpected error during {action}: Status code {response.status_code}. {error_message} - {error_details}"
raise FirecrawlError(message, response.status_code, response) |