Error Handling

{
  "error": "machine_readable_code",
  "message": "Human-readable description",
  "details": {}
}

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid or has been revoked"
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit: 100 documents/hour. Retry after 3600 seconds",
  "retry_after": 3600
}

{
  "error": "invalid_file_type",
  "message": "Only PDF files are supported. Received: image/jpeg"
}

{
  "error": "job_not_found",
  "message": "Job ID not found or does not belong to your tenant"
}

from tenacity import retry, stop_after_attempt, wait_exponential

@retry(
    stop=stop_after_attempt(3),
    wait=wait_exponential(multiplier=1, min=2, max=30)
)
def upload_document(file_path):
    response = requests.post(
        "https://api.docintell.com/v1/documents",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"file": open(file_path, "rb")}
    )

    if response.status_code == 429:
        raise Exception("Rate limited")
    if response.status_code >= 500:
        raise Exception("Server error")

    return response.json()