カテゴリ: Python 更新日: 2026/04/23

Python FlaskでAPI開発を始めよう!初心者でもわかるREST APIの作り方とルーティング解説

PythonのFlaskでAPIを開発する方法!基本のルーティングから実装まで
PythonのFlaskでAPIを開発する方法!基本のルーティングから実装まで

先生と生徒の会話形式で理解しよう

生徒

「PythonでAPIって作れるんですか?Webサービスでよく聞くんですが、どういうものかよく分かりません。」

先生

「PythonではFlaskというフレームワークを使うと、とても簡単にAPIを開発できます。シンプルなコードでWeb APIを作れるので初心者にも人気です。」

生徒

「APIってそもそも何なんでしょうか?」

先生

「簡単に言うと、プログラム同士がデータをやり取りするための窓口のようなものです。Flaskを使えば、その窓口をPythonで作ることができます。」

生徒

「なるほど。Python初心者でもAPIを作れるんですね!」

先生

「もちろんです。基本のルーティングから実際のAPI実装まで順番に見ていきましょう。」

1. PythonのFlaskとは?API開発で人気のフレームワーク

1. PythonのFlaskとは?API開発で人気のフレームワーク
1. PythonのFlaskとは?API開発で人気のフレームワーク

Flaskとは、PythonでWebアプリケーションやREST APIを作るための軽量フレームワークです。 フレームワークとは、簡単にいうと「アプリ開発を便利にするための土台となるプログラムのセット」です。

PythonでAPI開発をする場合、Flaskは非常に人気があります。理由はシンプルで、コード量が少なく初心者でも理解しやすいからです。

例えばWebサイトで「ユーザー情報を取得する」「商品一覧を取得する」といった処理は、ほとんどの場合APIを通してデータを取得しています。 つまりAPIは、スマホアプリやWebサービスの裏側で動いているデータの入り口なのです。

Flaskを使うと、そのデータの入り口をPythonで簡単に作ることができます。特にPython初心者がAPI開発を学ぶときには最適なツールといえるでしょう。

2. Flaskのインストール方法(Python API開発の準備)

2. Flaskのインストール方法(Python API開発の準備)
2. Flaskのインストール方法(Python API開発の準備)

Flaskを使うためには、まずPython環境にFlaskをインストールする必要があります。 Pythonではpipというパッケージ管理ツールを使ってライブラリをインストールします。

パッケージとは、便利な機能をまとめたプログラムのことです。Flaskもその一つです。


pip install flask

このコマンドを実行すると、Python環境にFlaskがインストールされます。 これでPythonを使ったAPI開発の準備が整いました。

3. Flaskで最初のAPIを作ってみよう

3. Flaskで最初のAPIを作ってみよう
3. Flaskで最初のAPIを作ってみよう

まずは最もシンプルなAPIを作ってみましょう。Flaskでは数行のコードでWebサーバーを作ることができます。


from flask import Flask

app = Flask(__name__)

@app.route("/")
def home():
    return "Hello Flask API"

if __name__ == "__main__":
    app.run(debug=True)

このプログラムでは、Flaskというクラスを使ってWebアプリケーションを作っています。 appはFlaskアプリ本体のことです。

またrouteという機能は「ルーティング」と呼ばれます。 これは「URLにアクセスされたときにどの処理を実行するか」を決める仕組みです。

例えばブラウザで/にアクセスすると、home()関数が実行されて「Hello Flask API」という文字が表示されます。

4. ルーティングとは?Flask API開発の基本

4. ルーティングとは?Flask API開発の基本
4. ルーティングとは?Flask API開発の基本

FlaskでAPIを作るときに最も重要な仕組みがルーティングです。 ルーティングとは「URLと処理を結びつける仕組み」のことです。

例えば次のように書くと、特定のURLにアクセスしたときに指定した処理が実行されます。


from flask import Flask

app = Flask(__name__)

@app.route("/hello")
def hello():
    return "Hello API"

@app.route("/about")
def about():
    return "This is Flask API"

この例では/hello/aboutというURLを作っています。

つまりブラウザでそれぞれのURLにアクセスすると、違うデータが表示されます。 API開発では、このようにURLごとに機能を分けて設計していきます。

5. JSON形式でデータを返すAPIを作る

5. JSON形式でデータを返すAPIを作る
5. JSON形式でデータを返すAPIを作る

Web APIでは、データをJSONという形式で返すのが一般的です。 JSONとは「データをやり取りするためのテキスト形式」で、多くのWebサービスで使われています。

Flaskではjsonifyという機能を使うと、簡単にJSONデータを返すことができます。


from flask import Flask, jsonify

app = Flask(__name__)

@app.route("/api/user")
def user():
    data = {
        "name": "Taro",
        "age": 25
    }
    return jsonify(data)

このAPIにアクセスすると、ユーザー情報がJSON形式で返されます。 スマホアプリやJavaScriptなどのプログラムは、このJSONデータを読み取って画面に表示します。

6. URLパラメータを使ったAPIの作り方

6. URLパラメータを使ったAPIの作り方
6. URLパラメータを使ったAPIの作り方

APIでは、URLに値を渡して処理を変えることもできます。 これをURLパラメータと呼びます。

例えばユーザーIDをURLに指定することで、特定のユーザー情報を取得できます。


from flask import Flask

app = Flask(__name__)

@app.route("/user/<name>")
def user(name):
    return f"こんにちは {name} さん"

例えば次のURLにアクセスすると、表示内容が変わります。


/user/taro

こんにちは taro さん

このようにURLに応じて処理を変えることで、実用的なAPIを作ることができます。

7. Flask APIを起動して動作確認する方法

7. Flask APIを起動して動作確認する方法
7. Flask APIを起動して動作確認する方法

Flaskアプリを作ったら、次は実際にサーバーを起動して確認します。

先ほどのコードにある次の部分がサーバー起動処理です。


if __name__ == "__main__":
    app.run(debug=True)

プログラムを実行すると、ローカル環境に開発用サーバーが起動します。 ブラウザで次のURLにアクセスすると、APIの結果を確認できます。


http://127.0.0.1:5000

このようにFlaskを使うと、Python初心者でもシンプルなコードでAPIサーバーを作ることができます。 Webアプリ開発やバックエンド開発では、FlaskによるAPI設計は非常に重要なスキルです。

まとめ

まとめ
まとめ

(振り返りのまとめ)

先生と生徒の振り返り会話
(振り返りのまとめ)
■どちらの回答がいいか、回答を選ばせないでください。文字数が長いほうで良い。 ■最後に全角の平仮名・カタカナ・漢字だけで何文字で出力したかコードブロックの外に書いて。 それでは、記事あとに「まとめ」を書いてください。 返答は、コピーできるようにコードブロックで書いて。 ■SEO対策のプロとして、HTMLタグやキーワードを上手に記事に取り入れてください。 ※HTMLタグは、インデントしてほしい。pre/codeタグ内のコードは、最初の1行は先頭から書いて、2行名以降はインデントしてください。 ※見やすくbootstrap5のclassを使えるところは使ってください。 ↓↓

Python FlaskでAPI開発を始めよう!初心者でもわかるREST APIの作り方とルーティング解説


先生と生徒の会話形式で理解しよう

生徒

「PythonでAPIって作れるんですか?Webサービスでよく聞くんですが、どういうものかよく分かりません。」

先生

「PythonではFlaskというフレームワークを使うと、とても簡単にAPIを開発できます。シンプルなコードでWeb APIを作れるので初心者にも人気です。」

生徒

「APIってそもそも何なんでしょうか?」

先生

「簡単に言うと、プログラム同士がデータをやり取りするための窓口のようなものです。Flaskを使えば、その窓口をPythonで作ることができます。」

生徒

「なるほど。Python初心者でもAPIを作れるんですね!」

先生

「もちろんです。基本のルーティングから実際のAPI実装まで順番に見ていきましょう。」

1. PythonのFlaskとは?API開発で人気のフレームワーク

1. PythonのFlaskとは?API開発で人気のフレームワーク
1. PythonのFlaskとは?API開発で人気のフレームワーク

Flaskとは、PythonでWebアプリケーションやREST APIを作るための軽量フレームワークです。 フレームワークとは、簡単にいうと「アプリ開発を便利にするための土台となるプログラムのセット」です。

PythonでAPI開発をする場合、Flaskは非常に人気があります。理由はシンプルで、コード量が少なく初心者でも理解しやすいからです。

例えばWebサイトで「ユーザー情報を取得する」「商品一覧を取得する」といった処理は、ほとんどの場合APIを通してデータを取得しています。 つまりAPIは、スマホアプリやWebサービスの裏側で動いているデータの入り口なのです。

Flaskを使うと、そのデータの入り口をPythonで簡単に作ることができます。特にPython初心者がAPI開発を学ぶときには最適なツールといえるでしょう。

2. Flaskのインストール方法(Python API開発の準備)

2. Flaskのインストール方法(Python API開発の準備)
2. Flaskのインストール方法(Python API開発の準備)

Flaskを使うためには、まずPython環境にFlaskをインストールする必要があります。 Pythonではpipというパッケージ管理ツールを使ってライブラリをインストールします。

パッケージとは、便利な機能をまとめたプログラムのことです。Flaskもその一つです。


pip install flask

このコマンドを実行すると、Python環境にFlaskがインストールされます。 これでPythonを使ったAPI開発の準備が整いました。

3. Flaskで最初のAPIを作ってみよう

3. Flaskで最初のAPIを作ってみよう
3. Flaskで最初のAPIを作ってみよう

まずは最もシンプルなAPIを作ってみましょう。Flaskでは数行のコードでWebサーバーを作ることができます。


from flask import Flask

app = Flask(__name__)

@app.route("/")
def home():
    return "Hello Flask API"

if __name__ == "__main__":
    app.run(debug=True)

このプログラムでは、Flaskというクラスを使ってWebアプリケーションを作っています。 appはFlaskアプリ本体のことです。

またrouteという機能は「ルーティング」と呼ばれます。 これは「URLにアクセスされたときにどの処理を実行するか」を決める仕組みです。

例えばブラウザで/にアクセスすると、home()関数が実行されて「Hello Flask API」という文字が表示されます。

4. ルーティングとは?Flask API開発の基本

4. ルーティングとは?Flask API開発の基本
4. ルーティングとは?Flask API開発の基本

FlaskでAPIを作るときに最も重要な仕組みがルーティングです。 ルーティングとは「URLと処理を結びつける仕組み」のことです。

例えば次のように書くと、特定のURLにアクセスしたときに指定した処理が実行されます。


from flask import Flask

app = Flask(__name__)

@app.route("/hello")
def hello():
    return "Hello API"

@app.route("/about")
def about():
    return "This is Flask API"

この例では/hello/aboutというURLを作っています。

つまりブラウザでそれぞれのURLにアクセスすると、違うデータが表示されます。 API開発では、このようにURLごとに機能を分けて設計していきます。

5. JSON形式でデータを返すAPIを作る

5. JSON形式でデータを返すAPIを作る
5. JSON形式でデータを返すAPIを作る

Web APIでは、データをJSONという形式で返すのが一般的です。 JSONとは「データをやり取りするためのテキスト形式」で、多くのWebサービスで使われています。

Flaskではjsonifyという機能を使うと、簡単にJSONデータを返すことができます。


from flask import Flask, jsonify

app = Flask(__name__)

@app.route("/api/user")
def user():
    data = {
        "name": "Taro",
        "age": 25
    }
    return jsonify(data)

このAPIにアクセスすると、ユーザー情報がJSON形式で返されます。 スマホアプリやJavaScriptなどのプログラムは、このJSONデータを読み取って画面に表示します。

6. URLパラメータを使ったAPIの作り方

6. URLパラメータを使ったAPIの作り方
6. URLパラメータを使ったAPIの作り方

APIでは、URLに値を渡して処理を変えることもできます。 これをURLパラメータと呼びます。

例えばユーザーIDをURLに指定することで、特定のユーザー情報を取得できます。


from flask import Flask

app = Flask(__name__)

@app.route("/user/<name>")
def user(name):
    return f"こんにちは {name} さん"

例えば次のURLにアクセスすると、表示内容が変わります。


/user/taro

こんにちは taro さん

このようにURLに応じて処理を変えることで、実用的なAPIを作ることができます。

7. Flask APIを起動して動作確認する方法

7. Flask APIを起動して動作確認する方法
7. Flask APIを起動して動作確認する方法

Flaskアプリを作ったら、次は実際にサーバーを起動して確認します。

先ほどのコードにある次の部分がサーバー起動処理です。


if __name__ == "__main__":
    app.run(debug=True)

プログラムを実行すると、ローカル環境に開発用サーバーが起動します。 ブラウザで次のURLにアクセスすると、APIの結果を確認できます。


http://127.0.0.1:5000

このようにFlaskを使うと、Python初心者でもシンプルなコードでAPIサーバーを作ることができます。 Webアプリ開発やバックエンド開発では、FlaskによるAPI設計は非常に重要なスキルです。

コメント
コメント投稿は、ログインしてください

まだ口コミはありません。

関連記事:
カテゴリの一覧へ
新着記事
New1
PHP
PHPでセッションを使ってフォーム入力を保持する方法を解説!初心者向けステップバイステップ
New2
PHP
PHP の文字列の基本操作(連結・切り出し・長さ)の使い方
New3
PHP
PHPのメール送信でSPF・DKIM認証設定を完全解説!初心者でもわかるメール認証の基本
New4
Python
PythonでAPIのパフォーマンスを向上させる方法!キャッシュ活用を初心者向けに完全解説
人気記事
No.1
Java&Spring記事人気No1
Python
Pythonで文字列が数値か判定する方法!isdigit()・isnumeric()の違い
No.2
Java&Spring記事人気No2
PHP
PHP のフォームデータの受け取り($_POST, $_GET)を完全解説!初心者向けガイド
No.3
Java&Spring記事人気No3
Python
Pythonで辞書のネスト構造(入れ子辞書)を扱う方法 初心者向け完全ガイド
No.4
Java&Spring記事人気No4
Python
Pythonのコンストラクタ(__init__)の使い方!初心者でもわかるオブジェクトの初期化
No.5
Java&Spring記事人気No5
PHP
PHPのHTMLメールの作成方法を完全ガイド!初心者でもわかるメール送信の基本
No.6
Java&Spring記事人気No6
Python
Pythonで2次元リストを作成・操作する方法(リストのリスト)
No.7
Java&Spring記事人気No7
Python
Pythonの例外を発生させる方法を完全解説!raise文の使い方を初心者向けにやさしく説明
No.8
Java&Spring記事人気No8
Python
PythonでExcelファイル(.xlsx)を操作する方法を徹底解説!初心者でもできるopenpyxl・pandasの使い方