（最終更新月：2022年12月）
✔このような方へ向けて書かれた記事となります
「APIって何？」
「API連携を具体例付きで説明してほしい」
「APIって自分で開発できるのだろうか？」
✔当記事を通じてお伝えすること
- APIで知っておくべき基礎知識
- APIを活用する方法
- APIの構築方法・手順
当記事では、APIとは何かについての解説はもちろん、一般的な事例を用いて、活用する方法や、自身で構築する方法までそれぞれ解説しています。
ぜひ最後までご覧ください。
✔当記事の信頼性
当ブログでは、Webアプリを開発・公開する方法をご紹介しています。
その中でご紹介してるWebアプリのひとつは、Django REST Frameworkで自作したAPIを使ったものです。
APIの構築を通じて学んだことをこちらでご紹介していきます。
筆者プロフィール
【現職】プロダクトマネージャー
【副業】ブログ（月間20万PV）/YouTube/Web・アプリ制作
「プログラミング × ライティング × 営業」の経験を活かし、30後半からのIT系職へシフト。現在はプロダクトマネージャーとして、さまざまな関係者の間に入り奮闘してます。当サイトでは、実際に手を動かせるWebアプリの開発を通じて、プログラミングはもちろん、IT職に必要な情報を提供していきます。
【当ブログで紹介しているサイト】
✔人に見せても恥ずかしくないコードを書こう
「リーダブルコード」は、わかりやすく良いコードの定義を教えてくれる本です。
- 見るからにきれいなコードの書き方
- コードの分割方法
- 変数や関数の命名規則
エンジニアのスタンダートとすべき基準を一から解説しています。
何回も読むのに値する本なので、ぜひ手にとって読んでみてください。
APIについて知っておくべき基礎知識3選
こちらではまず、APIについて知っておくべき基本事項をお伝えします。
APIとはよく聞くけれど、実際の定義などを明確に答えるのはなかなか難しいからです。
- APIとは？
- API3つの種類
- API連携とは？
- APIの事例
APIとは？
APIとは、Application Programming Interfaceの頭文字を繋いだもので、アプリケーションプログラムとの接点などと訳せます。
アプリケーション利用者と提供者それぞれのソフトウェアをつなぐことで、既存のプログラムが持つ機能を使えるようするのが役割です。
例えば、以下のようなAPIが身近に存在しています。
- Twitter API
- Google Map API
- LINE Messaging API
あるプログラムから、別のプログラムの機能を使いたいときにAPIを活用するのです。
API3つの種類
APIには以下の種類があります。
- Web API
- OS API
- プログラム（ランタイム） API
GoogleやAmazonなどが提供しているのはWeb APIですが、プログラムの機能などにより、異なる種類のAPIが存在するのです。
API連携とは？
API連携とは、実際にAPIを通して、プログラム同士を連携させること。
APIを活用することで、一からプログラムを構築する必要がなく、既存の機能を流用して新しいアプリケーションが作れるのです。
例えば、以下のページではOpenAI（ChatGPT）のAPIを活用してアプリを作る方法を載せています。
APIの事例
APIの事例をご紹介します。
APIの事例を理解することで、より具体的にどのように役立っているかがわかるでしょう。
フロントエンドなどの構築を練習するのに以下のような無料APIサービスがあります。
スターウォーズに出てくる人や乗り物などがJSON形式のデータで返される簡単なAPIです。
REACTを使っての利用方法は以下の記事でも解説しています。
APIの活用方法
以下の記事では、Pythonを使って、APIへアクセス・APIの構築を解説しています。
自身で触れることで、APIがどんなものかが理解できるはず。
API開発・構築について知っておくべきこと3つ
APIを開発したい・構築したい方に向けて、知っておくべき事項を3つご紹介します。
作ってみると難しくないものの、前提として必要な知識があるからです。
- API開発に必要なプログラミングスキル
- API認証3つの方式
- APIセキュリティ
API開発に必要なプログラミングスキル
APIを開発するのに使える主な言語は以下の3つ。
- Python
- JavaScript
- PHP
プログラミング言語の知識だけでなく、フレームワークについても知っておく必要があります。
最近ではノーコードで開発できるサービスも出てきているので、プログラミングが苦手な方はノーコード開発プラットフォームを活用するのもおすすめです。
API認証3つの方式
API認証には以下の方式が存在します。
- HTTP方式：主にパスワードを使う方法
- APIキー認証：サービスから提供されたキーを使用する方法
- Form認証・アクセストークン認証：パスワードにより、トークンを取得し使う方法
APIの認証方法により、利便性やセキュリティ性が異なります。
またAPIサービスの提供側で複数のサービスを提供している場合などはアクセストークンによる認証が有効です。
APIセキュリティ
APIセキュリティには、主に以下の2つの側面があります。
- 利用者側のプログラムにおけるAPIセキュリティ
- 提供者側のAPIサービスのセキュリティ
APIの利用時には個人情報などを取り扱う場合もあります。
さまざまなリスクを鑑みて、プログラム開発に臨むべきといえるでしょう。
APIの構築手順
こちらでは、Python言語を使ってAPIを構築する手順をご紹介します。
Python言語をベースとしたDjangoフレームワークの「Django REST Framework」を使っています。
- APIのエンドポイント（URL）を決定する
- どのようなデータを受け取るかを決める
- 受け取ったデータの処理をする
- 処理をしたデータをレスポンスで返す
詳しいAPIの構築方法はこちらの記事で、サンプルのコードを含めてご紹介しています。
Django REST Frameworkについてはこちらをご覧ください。
まとめ：APIを活用することで、外部のプログラム機能を流用できる
当記事の内容をまとめます。
- APIとは、プログラムとプログラムを繋ぐ接点のこと
- APIを活用すれば、さまざまな機能を簡単に実装できる
- Webアプリを作りたいなら、APIについて詳しくなることは必須
さまざまなWebアプリケーションでは、APIが提供されています。
APIを活用することで、あなた自身のアプリにその機能を実装することができるのがメリットです。
ぜひいろいろな機能を探して、あなたのアプリをより魅力的なものにしてください。
また以下のページでは、自作したAPIプログラムを公開しています。
構築方法やそのコードはこちらの記事をご覧ください。