Minor improvements in docs

[dpieski]

Minor documentation and robustness updates

Summary

This pull request introduces a focused set of minor improvements on top of main.

Included commits

• aligned the backoff factor default
• Add JSON parsing error handling
• Document include_raw_data flag
• Document HTTP method restrictions
• Add pagination validation
• update documentation

Scope of changes

• Documentation clarifications and new examples
• Improved error handling for API responses
• Validation and configuration default alignment