APIとは？非エンジニアにもわかるシステム連携の仕組みをやさしく解説

「APIで連携しています」「APIを叩く」という言葉、IT現場では当たり前のように出てきます。でも、APIが何なのか、何をするためのものかを説明できる非エンジニアは少ないかもしれません。

この記事では、APIとは何かを、できるだけわかりやすくまとめます。

この記事でわかること

API（Application Programming Interface）とは、**異なるシステム・ソフトウェアが互いに機能やデータをやり取りするための「接続口」**です。

難しい言葉が並びますが、要は「このシステムの機能を外部から使えるように公開した入口」です。

レストランのメニューと注文システムで考えてみます。

お客さんはキッチンの中に入って直接料理を作るわけではありません。メニューを見て「ハンバーグ定食」と注文すると、決まった形で料理が出てきます。メニューが「何を頼めるか」を定義していて、注文という形でキッチンの機能を使えます。

APIはこのメニューに相当します。「何を頼めるか（どんなリクエストを送れるか）」「何が返ってくるか（どんなデータが返ってくるか）」が決まっていて、外部のシステムがそのルールに従って機能を使います。

キッチンの中がどうなっているか（どのようにコードが書かれているか）は知らなくても、メニュー（API）のルールに従えば注文（リクエスト）して料理（データ・機能）を受け取れます。

天気予報アプリ：天気情報を持っているサービスが「今日の天気をください」というAPIを公開しています。天気アプリはそのAPIにアクセスして、データを取得して画面に表示します。天気アプリ自体が天気データを持っているわけではありません。

ログイン機能（Googleアカウントでログイン）：「Googleアカウントで続ける」ボタンを押すと、そのサービスがGoogleの認証APIを使っています。自前でパスワード管理システムを作らなくても、GoogleのAPIを使って認証できます。

地図表示：Webサイトやアプリに地図が表示されているとき、多くはGoogleマップなどの地図APIを使っています。

SFA・CRMとの連携：「Salesforceのデータをこのシステムで使いたい」というとき、SalesforceのAPIを使ってデータを取得・更新します。

エンジニア同士の会話に出てきたとき、以下の文脈で理解しておくと役立ちます。

「外部サービスとAPIで連携する」：自社システムと外部サービス（決済・メール・認証など）をAPIでつなぐということです。

「APIを設計する（APIを作る）」：他のシステムから使えるように、自社システムの機能を公開することです。

「APIの仕様書（APIドキュメント）を確認する」：APIの入口（エンドポイント）・リクエスト形式・レスポンス形式が書かれた説明書です。

PMや非エンジニアの立場では、「このシステムは外部のAPIを使っているのか」「APIのレート制限（1分間に何回まで使えるかの制限）は考慮しているか」という観点でエンジニアに確認できると、品質とリスク管理に役立ちます。

「APIを叩く」という言葉が物理的に聞こえる

「叩く」はAPIにリクエストを送ることを指す俗語です。「APIを呼び出す」「APIにアクセスする」と同じ意味です。

APIとURL（エンドポイント）を混同している

APIは「機能全体（天気情報のやり取りができる仕組み）」を指し、エンドポイントは「APIにアクセスするための具体的なURL」です。「https://api.example.com/weather」がエンドポイントの例です。

APIは誰でも自由に使えると思っている

APIには認証が必要なものが多く、使いすぎると制限がかかるもの（レートリミット）もあります。また有料のAPIもあります。

APIを含むWebの仕組みを体系的に学びたい方には、FEXシリーズのWebの仕組み入門講座がおすすめです。