APIモードで始める！rails new --apiと通常モードの違いと選び方を初心者向けに解説
生徒
「rails newってコマンドに--apiってつけると、何か違うんですか？」
先生
「いい質問ですね。--apiをつけると、RailsがAPI専用の軽い構成でアプリを作ってくれますよ。」
生徒
「APIって何ですか？どういうときに使うんですか？」
先生
「それでは、APIモードと通常モードの違いや選び方を、初心者にもわかるように解説していきましょう！」
1. APIモードとは？
rails newに--apiをつけると、RailsがAPI専用のアプリを作成します。API（エーピーアイ）とは「アプリケーション・プログラミング・インターフェース」の略で、簡単に言えばアプリ同士が会話するための仕組みです。
たとえば、スマホアプリがサーバーにデータを送ったり、Webアプリがバックエンドのデータベースとやり取りしたりする時にAPIが使われます。
2. rails new --api の書き方
APIモードでRailsアプリを作るには、rails newの後に--apiをつけるだけです。
rails new my_api_app --api
これだけで、API専用に最適化された軽量なRailsアプリが作られます。
3. 通常モード（Webアプリモード）との違い
通常のrails newは、Web画面付きのフル機能のアプリを作ります。HTMLファイル、CSS、JavaScript、ビュー、レイアウトなど、Web画面を表示するための仕組みがすべて入っています。
一方でAPIモードは、それらを省いて軽くした構成になっており、データだけをやり取りする用途に特化しています。
| 項目 | 通常モード | APIモード（--api） |
|---|---|---|
| HTML表示 | あり（ビューが使える） | なし（JSON出力のみ） |
| CSS/JS | 自動生成あり | スキップされる |
| レイアウト | あり | なし |
| アプリの重さ | やや重い | 軽い |
| 適した用途 | Webサイト全体を作るとき | スマホアプリの裏側など |
4. 具体的な使い分け例
通常モードを選ぶ場面：
- Webブラウザで画面を表示するサイトを作りたい
- ログインやフォームなど、ユーザー操作を画面で見せたい
- HTMLやCSSもRailsで扱いたい
APIモードを選ぶ場面：
- スマホアプリとデータのやり取りだけしたい
- VueやReactなど、別の画面表示ツールと連携したい
- バックエンドだけRailsで作って、画面は他で作るとき
5. APIモードの開発体験はどう違う？
APIモードでは、コントローラの出力がJSON（ジェイソン）形式になります。JSONは、アプリ同士が読み書きできるデータの形で、人間が読める文法でもあります。
例えば次のような出力になります。
{
"message": "こんにちは",
"user_id": 1
}
画面は出ませんが、このような「データ」だけを返すことで、スマホアプリやフロントエンドのシステムとつながります。
6. 初心者におすすめなのはどっち？
プログラミング未経験の方には、最初は通常モードがおすすめです。なぜなら、画面で確認できるからです。フォームやページが見えて、コードと結果が結びつきやすいです。
逆にAPIモードは、画面が出ず、データしか返ってこないため、最初は少し戸惑うかもしれません。
「画面は他の人が作るから、データだけ用意したい」という場面で、--apiが活躍します。
7. APIモードの起動確認方法
APIモードでアプリを作ったら、次のコマンドで動作確認ができます。
cd my_api_app
bin/rails server
ブラウザで表示しても画面は出ませんが、URLにアクセスするとJSON形式でメッセージが返ってくるはずです。
まとめ
APIモードと通常モードの違いを整理しよう
今回の記事では、Railsでアプリケーションを作成する際に重要となる「APIモード」と「通常モード」の違いについて、基礎から丁寧に確認してきました。rails new コマンドに --api を付けるかどうかによって、生成されるRailsアプリの構成や役割は大きく変わります。APIモードは、画面表示を行わず、JSON形式のデータを返すことに特化した軽量な構成となっており、スマホアプリやフロントエンドフレームワークとの連携に適しています。一方、通常モードはHTMLやCSS、JavaScriptを使ったWeb画面を含むフル機能のRailsアプリとなり、初心者が学習を始める際にも理解しやすい構成です。
RailsのAPIモードは、バックエンド開発に集中したい場合や、ReactやVueなどのフロントエンドと分離した設計を行いたい場合に力を発揮します。コントローラではJSONを返すことが基本となり、画面を持たない代わりに処理がシンプルで高速です。そのため、APIサーバーとしてRailsを利用するケースでは、無駄のない構成で開発を進められるというメリットがあります。
APIモードの基本構成を振り返る
APIモードで作成したRailsアプリでは、ビューやレイアウトが生成されず、コントローラはデータを返す役割に専念します。以下は、APIモードでよく使われるシンプルなレスポンス例です。
render json: { status: "ok", message: "APIが正常に動作しています" }
このように、APIモードでは画面表示ではなく、データの受け渡しが中心になります。Railsのルーティングやコントローラの仕組み自体は通常モードと同じなので、Railsの基本を理解していればスムーズに移行できます。ただし、セッション管理やCookieの扱いなど、一部の機能はAPI向けに最適化されている点を意識する必要があります。
どちらを選ぶべきかの考え方
初心者がRailsを学ぶ場合は、まず通常モードでWebアプリケーションの全体像を理解することが近道です。画面が表示され、入力フォームやリンクの動きが目で確認できるため、Railsの仕組みを直感的に学べます。その後、APIモードに挑戦することで、より実践的なバックエンド開発の考え方を身につけることができます。用途や目的に応じて、APIモードと通常モードを使い分けることが、Railsを効率よく活用するポイントです。
生徒
「APIモードって画面が出ないから難しそうだと思っていましたが、役割がはっきりしているんですね。データを返すだけと考えると、少しイメージしやすくなりました。」
先生
「その通りです。APIモードは、Railsをバックエンド専用として使うときにとても便利です。通常モードと基本の仕組みは同じなので、怖がる必要はありません。」
生徒
「最初は通常モードで学んで、慣れてきたら rails new --api を使う、という流れが良さそうですね。」
先生
「はい、それが王道です。Railsは用途に応じて柔軟に使えるのが魅力ですから、APIモードと通常モードの違いを理解しておくと、将来の開発の幅が広がりますよ。」
生徒
「今回の内容で、RailsのAPI開発がどんな場面で使われるのか、はっきり分かりました。次はJSONの扱い方も勉強してみたいです。」
この記事を読んだ人からの質問
