APIとは?
API(Application Programming Interface)は、異なるソフトウェアアプリケーション同士が通信できるようにする一連のルールとプロトコルです。リクエストとデータをどのように構造化すべきかを指定し、アプリケーションがスムーズにやり取りできるようにします。
ユニバーサルリモコンの例え
API はユニバーサルリモコンに例えられます。リモコンで内部の仕組みを知らなくてもさまざまなデバイスを操作できるように、API はアプリケーションが背後で何が起きているかを知らなくても連携できるようにします。
この例えでは、
- リモコンは API インターフェースのようなものです。
- リモコンのボタンは API エンドポイントのようなものです。
- ボタンを押すユーザーは、リクエストを送信する 2 番目のアプリケーションのようなものです。
- 応答するテレビやデバイスは、それらのリクエストを実行するアプリケーションのようなものです。
テレビがその信号をどのように処理するかを知らなくても、チャンネルを変えるために特定のボタンを押すように、1 つのアプリケーションは、内部の仕組みを理解しなくても、別のアプリケーションの API を使ってデータを要求したりアクションを実行したりできます。
SaaS API の例
多くの SaaS(Software as a Service)アプリケーションが API を提供しています。例えば:
- ClickUp API は、タスクの作成、タスクの検索、コメントの追加、ファイルの添付など、多数のエンドポイントを提供しています。
- Gmail API を使用すると、メールの送信、既読にする、受信トレイの別のフォルダーに移動することができます。
- Notion API を使用すると、ページの更新、データベースの作成、データベース項目の情報の取得などができます。
API エンドポイント、入力、出力
API は API エンドポイント と呼ばれるサービスのリストで構成されています。各エンドポイントは特定のアクションを実行します。Make は あらゆる API への呼び出しをオーケストレーションする ソリューションであり、あらゆる種類のプロセスを定義できます。API エンドポイントには 入力(実行するアクションを理解するため)が必要で、出力(呼び出し元のアプリケーションに結果を返すため)を提供することに注意することが重要です。
リモコンで、テレビが目的のチャンネルに切り替わる(出力)には、正しいボタンを押す(入力)必要があるのと同じように、API も望ましい結果を返す前に特定の情報を必要とします。
API ドキュメントの読み方:ClickUp の例
ClickUp API documentation は、API が Make にとってなぜ不可欠であるかの明確な例を示しています。
ClickUp API ドキュメントでは、次のことがわかります。
- 利用可能なエンドポイントのリスト:ClickUp の API を通じて利用できるエンドポイントの包括的なカタログで、「Get Tasks」、「Create Task」などのオプションが含まれます。(A)
- 「Create a Task」エンドポイントの手順:「Create a Task」エンドポイントの使用方法に関する詳細なガイドライン。必要な入力:タスクの名前、ステータス、その他の必要なパラメーター。期待される出力:作成されたタスクに関する包括的な情報。(B)
- エンドポイントへのアクセス場所:この特定のエンドポイントにアクセスする場所と方法に関する情報。(C)
- エンドポイント呼び出しの実践例:「Create a Task」エンドポイントを効果的に呼び出す方法を示す実際の例。(D)
Make が API をどのように使用するか
API は、アプリケーション間で情報やサービスを交換するための便利な方法です。Make は、さまざまな SaaS アプリケーションのこれらの API を活用し、あらゆる API への呼び出しをオーケストレーションするソリューションとして機能します。Make はすでに 2,000 を超える API(つまり 2,000 の異なるアプリケーション)と連携しており、この数は絶えず増加しています。
公式ソース:What's an API? - Help Center · 確認日:2026-09-30