「PythonでWeb APIを作成する方法—簡単なバックエンドを構築してみよう」

近年、Web制作においてフロントエンドとバックエンドを分けて開発する「API駆動型」のアプローチが主流になっています。PythonはシンプルなコードでWeb APIを構築できるため、初心者にもおすすめの言語です。この記事では、Pythonを使って簡単なWeb APIを作成する方法をステップごとに解説します。

Web APIとは？

Web API（Application Programming Interface）は、クライアント（ブラウザやモバイルアプリ）とサーバーがデータをやり取りする仕組みです。これを利用することで、以下のようなことが可能になります：

• フロントエンドとバックエンドを分離した開発
• モバイルアプリや他のサービスとの連携
• データベースの管理や処理の効率化

PythonでWeb APIを構築するために必要な準備

PythonでAPIを構築するには、軽量なWebフレームワークFlaskを使用します。まずは環境を準備しましょう。

1. Flaskのインストール

以下のコマンドを実行してFlaskをインストールします：

pip install flask

2. 最小構成のAPIを作成する

以下のコードは、Flaskを使った最小限のWeb APIの例です。

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/hello', methods=['GET'])
def hello():
    return jsonify({'message': 'Hello, World!'})

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

このコードをapp.pyというファイル名で保存し、以下のコマンドで実行します：

python app.py

ブラウザでhttp://127.0.0.1:5000/api/helloにアクセスすると、次のようなJSONレスポンスが表示されます：

{"message": "Hello, World!"}

実践：簡単なタスク管理APIを作成

次に、より実践的な例としてタスク管理APIを作成してみましょう。

1. APIエンドポイントの設計

2. コード例

from flask import Flask, request, jsonify

app = Flask(__name__)

# 仮のタスクデータ
tasks = []

# タスク一覧を取得
@app.route('/api/tasks', methods=['GET'])
def get_tasks():
    return jsonify(tasks)

# 新しいタスクを追加
@app.route('/api/tasks', methods=['POST'])
def add_task():
    data = request.json
    task = {'id': len(tasks) + 1, 'title': data['title']}
    tasks.append(task)
    return jsonify(task), 201

# タスクを削除
@app.route('/api/tasks/<int:task_id>', methods=['DELETE'])
def delete_task(task_id):
    global tasks
    tasks = [task for task in tasks if task['id'] != task_id]
    return jsonify({'message': 'Task deleted'}), 200

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

実行方法

1. 上記のコードを実行します。
2. 以下のようなリクエストを送信してAPIを試してみましょう。

GETリクエストでタスク一覧を取得

curl http://127.0.0.1:5000/api/tasks

POSTリクエストで新しいタスクを追加

curl -X POST -H "Content-Type: application/json" -d '{"title": "Learn Python"}' http://127.0.0.1:5000/api/tasks

DELETEリクエストでタスクを削除

curl -X DELETE http://127.0.0.1:5000/api/tasks/1

データベースとの連携

より実用的なAPIを作るために、SQLiteなどのデータベースと連携させることも可能です。以下はSQLiteとSQLAlchemyを使った例です：

pip install flask-sqlalchemy

FlaskでAPIを作成する際の注意点

1. セキュリティ
   • データの検証や認証機能を追加しましょう。
2. ドキュメントの整備
   • Swaggerなどを使ってAPIドキュメントを作成することで、利用者に優しいAPIになります。

まとめ

PythonとFlaskを使えば、簡単にWeb APIを作成できます。この記事の手順を参考に、まずは小さなプロジェクトを構築してみましょう。次のステップとして、データベースとの連携やユーザー認証機能の追加に挑戦してみるのもおすすめです！

API開発の第一歩を踏み出し、Web制作のスキルをさらに高めていきましょう！