The MealDB API

This gem is for educational use only. I have created this to have a practice on how to create an API wrapper for Rails and create it in a ruby gem.

You may check The MealDB website here. The API and their site will always remain free at point of access. If you love their service and want extra features you can sign up as a Patreon supporter for $2.

Add this line to your application's Gemfile:

gem 'themealdb_rubygem'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install themealdb_rubygem

Instance of the client must be done first before being able to use the API. Since The MealDB have endpoints for free users and paid users, you can just create an instance without passing any api_key.

client = ThemealdbRubygem::Client.new

client = ThemealdbRubygem::Client.new(api_key: YOUR_API_KEY)

client.search_by_name("Arrabiata")

client.search_by_first_letter("a")

client.search_by_id("52772")

client.random_meal

client.list_categories_full

client.list_categories

client.list_areas

client.list_ingredients

Note that for paid users (those with api keys), ingredient variable can hold multiple strings (ingredient = "chicken_breast,garlic,salt").

client.filter_by_main_ingredient("chicken breast")

client.filter_by_category("Seafood")

client.filter_by_area("Canadian")

Bug reports and pull requests are welcome on GitHub at https://github.com/michael-dollosa/themealdb_rubygem. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting in the TheMealDB API project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.