Back to Changelog
Feature

SDK Improvements and New Features

New SDK features including automatic pagination, improved error handling, and comprehensive examples.

We've shipped significant improvements to both the Python and R SDKs based on early user feedback.

Automatic Pagination

Both SDKs now support automatic pagination for large result sets:

# Python - fetch all results automatically
all_concepts = client.search.basic_all("diabetes", page_size=100)
# R - same pattern
all_results <- client$search$basic_all("diabetes", page_size = 100)

Improved Error Handling

We've added structured error classes to make error handling more predictable:

  • AuthenticationError - API key issues
  • NotFoundError - Resource not found (404)
  • RateLimitError - Rate limit exceeded
  • ValidationError - Invalid request parameters

New Examples

Both SDK repositories now include comprehensive example scripts:

ExampleDescription
basic_usageGetting started with the client
search_conceptsSearch capabilities and filters
navigate_hierarchyTraversing concept hierarchies
map_between_vocabulariesMapping between ICD-10, SNOMED, etc.
error_handlingHandling errors gracefully

Documentation Updates

Our documentation at docs.omophub.com has been expanded with:

  • Detailed API reference
  • SDK-specific guides
  • Common use case tutorials
  • Troubleshooting guides

Thank you to everyone who provided feedback during our launch!