Creating an API with Ruby on Rails is simple and quick. The nature of Ruby allows it to use external services easily, which is why it is a great idea to develop an API using Ruby on Rails.
When a developer says that they are using Rails as the API, it indicates that they are using Ruby on Rails Development to build the backend, which is shared between the web application and native applications. Let’s see how you can develop an API using RoR.
What is an API application?
Application Programming Interface, or API, allows complement to interact with one another. One can request from the Rails app to fetch information by providing URLs.
What is Ruby on Rails?
The best part about Ruby on Rails is that it is open-source software. Users can utilize Ruby on Rails to develop applications or collaborate to bring change to their code.
Ruby on Rails focuses on opting for convention rather than configurations and optimized systems for programmers. Ruby on Rails works excellently with other technologies like Java, CSS, and HTML.
Example: Ruby on Rails API Development Steps
Step 1: API creation using Rails
To initiate the creation of an API, one must first write the below-written code in the terminal of any chosen directory. Using the code written below will create an API named secret_menu_api
$ rails new secret_menu_api –-api --database=postgresql
You must type the below-written code in the terminal to open the API menu.
$ cd secret_menu_api code
Step 2: Enabling CORS (Cross-Origin Resource Sharing)
CORS enables other people to access the API. To prevent other people from accessing the API, one can disable the CORS. To open the cors.rb file, you need to open the file explorer where the Rails API created now is present.
config > initializers > cors.rb
You must uncomment the lines and change the code from origins ‘example.com’ to origins’*’.
Rails.application.config.middleware.insert_before 0, Rack::Cors do
allow do
origins '*'
resources '*',
headers: :any,
methods: [:get, :post, :put, :patch, :delete, :options, :head]
end
end
Open Gemfile by scrolling down from the explorer file. Uncomment gem ‘rack-cors’ in line number 26.
gem 'rack-cors'
Open the terminal and run
$ bundle install
Step 3: Create a Controller, Model along with a table with
$ rails g resource Post title description
After using the command, it will then generate the below-mentioned files.
Model [Post]
:
app > models > post.rb
Controller
:
app > controllers > posts_controller.rb
Route
:
config > routes.rb
Database Migration Table:
db > migrate > 20230127064441_create_posts.rb
Step 4: Attributes of Post Model
- Title of the post
- Description of the post
Specifying attributes
Add the following Code into db > migrate > 20230127064441_create_posts.rb:
class CreatePosts < ActiveRecord::Migration[6.0]
def change
create_table :posts do |t|
t.string :title
t.text :description
end
end
end
Migrating the table
$ rails db:migrate
If the data has been migrated successfully, then you will be able to see the following:
== 20230127064441 CreatePosts: migrating =============================
-- create_table(:posts)
-> 0.0022s
== 20230127064441 CreatePosts: migrated (0.0014s) ====================
Step 5: Defining display, index, destroy, update, and create actions.
Here are the implications of the actions:
- Index: It will display all the posts present in the database.
- Show: It will display the specific(given as an id) post.
- Create: It will make the post’s instance.
- Update: It will update the post-item instance.
- Delete: It will delete specific post items.
Now copy and then paste the below code in secret_menu_intems_controller.rb.
Now let's write API magic over here.
app > controllers > posts_controller.rb
class PostsController < ApplicationController
def index
posts = Post.all
render json: posts, status: 200
end
def show
post = post.find_by(id: params[:id])
if post
render json: post, status: 200
else
render json: { error: “Post Not Found” }
end
end
def create
post = Post.new(
title: params[:title],
description: params[:description]
)
if post.save
render json: post
else
render json: { error: “Error on creating a record” }
end
end
def update
post = Post.find_by(id: params[:id])
post.update(
title: params[:title],
description: params[:description]
)
render json: {message: “#{post.title} has been updated!”, status: 200}
end
def destroy
post = Post.find_by(id: params[:id])
if post
post.destroy
render json: “#{post.title} has been deleted!”
else
render json: { error: “Post Not Found” }
end
end
end
Step 6: Creating routes for index, create, show, delete, and update actions.
Routes receive HTTP requests that come from the client side. We have to forward it using the correct actions. To configure the route, copy the following code and paste it into the route.rb.
# config > routes.rb
Rails.application.routes.draw do
resources :posts, only: [:index, :show, :create, :update, :destroy]
end
Step 7: Seeding the data
Now in the database, create secret menu item instances.
# db > seed.rb
post1 = Post.create(title: "Better way to improve Ruby on Rails coding", description:"Lorem Ipsum is simply dummy text of the printing and typesetting industry.")
post2 = Post.create(title: "perfect Combination of Angular + Ruby on Rails", menu_description:"Lorem Ipsum is simply dummy text of the printing and typesetting industry.")
Seeding the data
$ rails db:seed
Verify if seeding was correctly done:
$ rails c
# It will now show a console
2.6.1 :002 >
Now you can extract all the instances of secret menu items by typing SecretMenuItem.all
2.6.1 :002 > Post.all
Post Load (0.1ms) SELECT "secret_menu_items".* FROM "posts"
=> #<ActiveRecord::Relation [#<Post id: 1, title: "Better way to improve Ruby on Rails coding", description:"Lorem Ipsum is simply dummy text of the printing and typesetting industry.">, #< Post id: 2, title: "perfect Combination of Angular + Ruby on Rails", menu_description:"Lorem Ipsum is simply dummy text of the printing and typesetting industry.">]>
If all the instances are visible, then the seeding was done correctly.
Check Your Magic
- Start rails server.
- Go to your preferred browser(Or you can check into POSTMAN also).
- Pass the following line into the browser URL
Conclusion
The digital world is becoming more and more API-driven, and API development is the prime need for effective and faster digitization. Developing APIs in Ruby on Rails is the first choice for businesses as it not just creates faster APIs but also in a secure and scalable way.
Being one of the top Ruby on Rails development company, our RoR developers develops APIs for our customers from various industry segments.
Feel free to get in touch with us to explore new ways and possibilities with API and RoR Development.
Note: This Post Was First Published On https://essencesolusoft.com/blog/ruby-on-rails-ror-api-development