APIとは

Web アプリケーションで頻繁に登場する API とは何か、どのような役割を担うものかを整理します。

1. APIの概要

API(Application Programming Interface)は、異なるシステムの間でデータをやり取りするための仕組みです。軽量な文字データを通じてシステム間のやり取りを行います。APIを通じたやり取りは、JSON形式やXML形式などの標準的なデータ形式で行われることが多いです。JSONは人間にも読みやすく、機械にとっても効率的に処理できるため、広く採用されています。

APIを利用することで、異なるシステム間で疎結合を実現できます。疎結合とは、お互いのシステムの依存度を最小限に抑えることを意味し、一方のシステムの変更が他方に与える影響を最小限に抑えることができます。結果として、システムの保守性が向上し、新しい機能の追加や変更が容易になります。

2. JSONデータ形式

JSON(JavaScript Object Notation)は、APIで最も広く使われるデータ形式です。キーと値のペアでデータを表現します。

以下はJSONデータの例です。

{
  "id": 1,
  "title": "タスク管理APIを作る",
  "completed": false,
  "tags": ["Python", "FastAPI"],
  "assignee": {
    "name": "田中太郎",
    "email": "tanaka@example.com"
  }
}

JSONの特徴は以下のとおりです。

  • 文字列は""(ダブルクォート)で囲む
  • 数値と真偽値(true / false)はそのまま記述する
  • 配列は[]で表現する
  • オブジェクト(入れ子構造)は{}で表現する
💡 ポイント
Pythonでは、jsonモジュールを使ってJSON文字列とPythonの辞書型を相互に変換できます。この後学習するFastAPIでは、このJSON変換が自動的に行われるため、開発者はPythonのオブジェクトをそのまま扱えます。