Learn about error handling and troubleshooting in the OcularAI SDK
OcularError
class, making it easy to catch any SDK-related issue.OcularError
class, allowing you to catch all SDK-specific errors with a single exception handler:
Error Type | Description | Common Causes |
---|---|---|
AuthenticationError | Issues with authentication | Invalid API key, expired credentials |
ValidationError | Invalid parameters or inputs | Incorrect ID format, missing required fields |
ResourceNotFoundError | Requested resource not found | Non-existent workspace, project, version, or export |
RateLimitError | API rate limits exceeded | Too many requests in a short period |
ServerError | Server-side errors | Internal server issues, maintenance |
NetworkError | Network connectivity issues | Connection problems, timeouts |
TimeoutError | Request timeout | Slow network, large dataset downloads |
Scenario | Error | Solution |
---|---|---|
Invalid API Key | AuthenticationError | Check that your API key is correct and has the necessary permissions |
Incorrect Workspace/Project ID | ResourceNotFoundError | Verify the IDs in the OcularAI Foundry platform |
Slow Downloads | TimeoutError | Increase the timeout setting or use a more reliable network |
”Too Many Requests” error | RateLimitError | Implement exponential backoff, reduce request frequency |
Server Maintenance | ServerError | Wait and retry after some time |