# yomomma-apiv2
[![example workflow](https://github.com/beanboi7/yomomma-apiv2/actions/workflows/test.yml/badge.svg)](https://github.com/beanboi7/yomomma-apiv2/actions/workflows/test.yml)
[![Heroku](https://byob.yarr.is/beanboi7/yomomma-apiv2/heroku/)](https://yomomma-api.herokuapp.com/jokes/)

**An API that insults yo momma.**
<br />


### [yomamma-api.herokuapp.com](https://yomomma-api.herokuapp.com/jokes) <br>
Can be seen listed on [Public-APIs](https://github.com/public-apis/public-apis#personality).

## API Usage

For the complete documentation check out [here.](https://beanboi7.github.io/yomomma-apiv2/) 

> P.S: API is rate limited to 5 calls/minute.

## Development

This API is based on [FastAPI](https://fastapi.tiangolo.com/) and currently hosted on [Heroku](https://www.heroku.com/).

To contribute, see [this](./CONTRIBUTING.md).

Contributors:<br>
<a href="https://github.com/beanboi7/yomomma-apiv2/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=beanboi7/yomomma-apiv2" />
</a>

## Acknowledgements

Thanks to [rdegges](https://github.com/rdegges) and [szymex](https://github.com/szymex73) for the jokes. Yo momma would be proud, atleast now.


## License

This software is licensed under the terms of the [MIT License](./LICENSE).