Add comprehensive API documentation

Publish OpenAPI-style docs and usage examples for discoverability.

---
**Labels:** documentation
**Maintainer:** [@mafzalkalwardev](https://github.com/mafzalkalwardev)
**Portfolio:** https://mafzalkalwardev.github.io
