Python関数からJSONオブジェクトを返す方法をわかりやすく解説

Pythonの関数からJSONオブジェクト（JSON形式の文字列）を返すには、標準ライブラリの json モジュールに含まれる json.dumps() 関数を使用します。この関数は、Pythonの辞書（dict）などのオブジェクトをJSON形式の文字列へ変換（シリアライズ）してくれます。

基本的な例

以下は、Pythonの辞書をJSON文字列に変換して返す関数のシンプルな例です。

import json

# Pythonの辞書
a = {'name': 'Sarah', 'age': 24, 'isEmployed': True}

def retjson():
    python2json = json.dumps(a)
    return python2json

result = retjson()
print(result)

出力結果

{"age": 24, "isEmployed": true, "name": "Sarah"}

コードのポイント

json.dumps() は、辞書の内容をJSONの仕様に沿った形式へ自動的に変換します。主な型の対応関係は以下の通りです。

• Pythonの True / False → JSONの true / false
• Pythonの None → JSONの null
• 辞書（dict）→ JSONオブジェクト
• リスト（list）→ JSON配列

indent引数で見やすく整形する

indent 引数を指定すると、インデント付きの整形されたJSONを出力できます。デバッグやログ出力の際に非常に便利です。

import json

a = {'name': 'Sarah', 'age': 24, 'isEmployed': True}

print(json.dumps(a, indent=4))

{
    "name": "Sarah",
    "age": 24,
    "isEmployed": true
}

まとめ

Pythonの関数からJSONオブジェクトを返すには、json.dumps() で辞書をJSON文字列に変換し、その結果を return するだけです。Web APIのレスポンス生成など、実務でも頻繁に使われる基本テクニックなので、ぜひマスターしておきましょう。