私は恥ずかしがらずにカウチポテトです。食料品を注文し、配達してもらい、バーンズ・アンド・ノーブルまでのドライブ時間を調べ、天気をチェックして家の中に留まるかどうかを確認します。 これが最善のアクションです。ソファの居心地の良い隅からすべてを実行できます。残念だと思うかもしれませんが、私は単純に便利なのだと主張します。そして、その便利さは API の力によるものだと考えています。
API（アプリケーション プログラミング インターフェース）は、私たちの日常生活の利便性を実現します。さまざまなアプリを接続して、簡単に通信したり情報を共有したりできるようになります。API は、新しいアプリをプログラミングするための多くの面倒な作業も実行します。
私は API の専門家と協力して、API の使用方法に関する初心者向けガイドとチュートリアルを作成しました。
または、API の使い方の基本だけを知りたい場合は、主なステップの簡単なバージョンを次に示します。
API を選択する: GitHub、Google の API エクスプローラー、またはウェブサイトの開発者セクションから API を見つけます。
API キーを取得します。この一意のコードは、アクセス用のパスワードのような役割を果たします。
ドキュメントを読む: API の機能とその使用方法を学習します。
リクエストを記述します。GET (取得)、POST (追加)、PUT (更新)、または DELETE メソッドを使用します。
テスト 接続:ステータス コードを確認します: 2xx = 成功; 4xx、 5xx = エラー。
これが少しコーディングが多すぎると思われる場合は、 ノーコード API 接続 用の Zapier などの自動化プラットフォームを使用するのが最善策です。これにより、 API ドキュメント を一切読まなくてもすべてのワークフローを調整できます。
目次：
APIとは何ですか?
APIは、さまざまなソフトウェア アプリケーションが相互に通信して情報を交換できるようにするデジタル仲介者のようなものです。特定の機能にアクセスしたり、アプリやサービスからデータを取得したりするために使用できるメソッド、パラメーター、およびデータ形式を定義します。
あなたのお気に入りの天気アプリについて考えてみましょう。API を利用して気象サービスからリアルタイムの気象データを取得し、デバイスに配信します。または、ソーシャル メディア プラットフォームを使用して別のアプリにログインする場合 (Candy Crush の Facebook ログインをご存知ですか?)、舞台裏では、あなたの身元を安全に認証するために動作する API が存在します。
APIを使い始める
これから多くの専門用語を使います。始める前に、知っておくべき API 用語をいくつか紹介します。
用語 | 定義 |
|---|---|
APIキー | APIへのアクセスを許可する文字と数字の一意のパスコード |
エンドポイント | APIがリソースに関するリクエストを受け取るデジタルの場所 |
リクエスト方法 | HTTP メソッド (GET、POST、PUT、DELETE) を使用して、API に実行したい操作を指示します。 |
API呼び出し | クライアント（あなたのコンピュータ）がサーバーにAPIリクエストを行うプロセス |
ステータス コード | APIレスポンスの本文に表示される数値コードで、リクエストが成功したかどうかを示します。 |
APIサーバー | 適切な応答を返す前に API リクエストを認証して処理します |
APIレスポンス | API サーバーによって生成され、クライアント (コンピュータ) に返される応答 |
APIキー
パスワードと同様に、API キーは一意のアクセス コードまたは認証トークンとして機能する文字と数字の文字列です。ほとんどの API にアクセスするにはこれが必要です。これは、APIの使用状況を追跡および制御するためのセキュリティ対策であり、許可されたユーザーまたはアプリのみがデータにアクセスできます。アプリにアクセスするにはパスワードが必要であるのと同様に、API にアクセスするには API キーが必要です。
これらのキーを見つけて使用する方法については、後で説明します。
エンドポイント
エンドポイントは、通常、特定のURLまたはWebアドレスの形式で、APIが別のアプリに接続する場所です。エンドポイントは、リクエストを受信し、そのリクエストへの応答を送信する場所として機能します。これらは、ユーザーが API を操作するための明確で標準化された方法です。
自動販売機を想像してみてください。中にはさまざまなスナックが入っているのがすべて見られ、必要なスナックを受け取るには特定のボタンを押す必要があります。API エンドポイントは自動販売機のボタンのようなもので、API から取得したい特定の情報やアクションを表します。API エンドポイントにリクエストを送信してそのボタンを「押す」と、API は必要な情報やアクションを認識し、必要なスニッカーズ バー (つまり、応答) を提供します。
リクエスト方法
API エンドポイントを介して実行したいことを伝えるには、リクエストを行う必要があります。使用できる特定の HTTP メソッドは次の 4 つです。
GET: API から特定のデータを取得するために使用されます。
POST:これは、新しいデータをサーバーに追加 (投稿) することを API に伝えます。
PUT: API 上の既存のリソースを更新するために使用されます。
DELETE:これは、ご想像のとおり、サーバーから既存のデータを削除するために使用されます。
これらのリクエストは、CRUD (作成、読み取り、更新、削除) と呼ばれることもあります。ほとんどのパブリック API では、他のユーザーがデータを改ざんできないように、GET (読み取り) リクエストのみを実行できます。結局のところ、誰でもいいというわけではないでしょう 気象 API にアクセスして天気データを変更します。
API呼び出し
API 呼び出しは、リクエストを作成し、API が要求されたデータを取得し、API から応答を取得するプロセスです。必要なのは、上記の HTTP メソッドのいずれかを使用してリクエストを行うことだけです。
コーヒーショップで飲み物を注文するときのことを考えてみてください。バリスタに何が欲しいかを伝えると、バリスタはあなたの注文をシステムに入れ、バリスタが飲み物を手渡します。API 呼び出しも同様に機能しますが、カフェインの含有量は少なくなります。
ステータス コード
リクエストを行うたびに、ステータス コードが返されます。この 3 桁の数字は、リクエストが成功したかどうかを示します。コードの最初の数字は、ステータスのカテゴリを表します。コードが2で始まる場合、リクエストは正常に処理されました。コードが 4で始まる場合、何かが間違っています。ステータス コードを使用すると、リクエストの結果を理解し、応答に基づいて次の動作を判断できます。
APIの使い方
Python 3 . 0を使用して、API の使用例を紹介します。他のコーディング言語を使用することもできますし、API 用のユーザーフレンドリーなインターフェースを提供する、Postman や RapidAPI (Mac 用) などの初心者向けの API プラットフォームもあります。しかし、Python は、言語に完全に精通していなくても、API を使用するための非常にアクセスしやすい方法です。
1。APIを選択する
利用可能なパブリック API は数千あります。GitHubやGoogle の API Explorerなどのディレクトリを検索して、興味のあるものを見つけることができます。特定の API を探している場合、ほとんどのサイトでは、詳細設定または開発者セクションの下に、多くの場合サイトの下部にリストされます (Spotify のこの例のように)。
このチュートリアルでは、Google のGmail APIを使用します。
2。APIドキュメントを参照してください
すべての API は、開始時に何らかのドキュメントを提供する必要があります。通常、アクセスできるさまざまなオブジェクト、パラメーター、エンドポイントを提供する参照セクションがあります。また、通常は、いくつかの異なる一般的な言語で表現された例や、Gmail API の場合は「クイックスタート」も提供されます。このドキュメントでは、次の内容について説明します。
APIでできること
APIを使用するための依存関係と要件
APIの使い方
API キーがある場合は、このドキュメントにも記載されています。
このチュートリアルに従うには、次のことを行う必要があります。
Python 3をインストールします。10。7(またはそれ以降のバージョン - 3までです。13.5私がこれを書いている時点では)。
pip パッケージ マネージャーをインストールします。
Google Cloud プロジェクトを作成します。
Gmail アカウントを作成します (まだお持ちでない場合)。
3。リクエストを書く
ここで、リクエストを記述するか、API に実行してほしい操作を伝えます。ここで、GET、POST、PUT、および DELETE メソッドが機能します。
Google が提供する定型コードを使用して、Gmail の API から GET リクエストを実行する方法は次のとおりです。これにより、Gmail に保存したラベルが取得され、コンソールにログされます。
サンプルのクイックスタートコードをコピーします。
Macのテキスト エディット やWindowsの メモ帳 などのテキストエディタを開きます。コードをテキスト エディターに貼り付けます。
このプロジェクトのすべてのファイルを保存するフォルダーに sample.py として保存します。これは作業ディレクトリと呼ばれます。
コマンドラインクライアント(Macの場合はターミナル 、Windowsの場合は コマンドライン )を開き、作業ディレクトリに移動します。(ヒント: ターミナルで、
cd + spacebar次に、プロジェクトフォルダをファイルシステムからターミナルにドラッグし、Enterキーを押します。python3 sample.pyと入力してEnterキーを押します。
すべてを正しく実行すると、Gmail のラベル データがすべて表示されるはずです。
アプリをAPIに接続する方法
アプリケーションをAPIと統合しようとしている場合でも、上記の手順はすべて適用されます。ただし、次のことも必要です。
接続しようとしているアプリの API ドキュメントを見つけます。
API キーを見つけます (ある場合)。
ドキュメントに記載されているプロトコル (依存関係のインストールなど) に従ってください。
コマンドラインを使用してリクエストを実行し、API 応答を返します。
もちろん、 Zapierを使用してアプリを接続できる場合は、それほど面倒なことをする必要はありません。
REST～の比較または～の違いGraphQL～の比較または～の違いSOAP API
次に、 本当に 覚える必要のないまったく新しい頭字語のセットを紹介します。API はアプリケーションが互いにAPIをリクエストしてデータを要求する一般的なメカニズムまたはプロトコルを指しますが、実際にはこれらの交換を実装するための主な方法が 3 つあります。
REST (representational state transfer) API、またはRESTful APIは、現在最も一般的なAPIフォームです。これは Web ベースであり、情報はオンラインで交換されます。REST API を使用してリクエストを行うと、API から利用可能なすべてのデータが受信されます。
GraphQL (クエリ言語) API も同様に動作しますが、すべてのデータを取得するのではなく、必要な特定のデータのみを取得して応答します。そのため、必要なフィールドを指定して、大量のデータ交換とそれに伴う読み込み速度の低下を回避できます。GraphQL API は比較的新しいため、それほど一般的ではありませんが、人気が高まっています。
SOAP (シンプル オブジェクト アクセス プロトコル) API は、プログラミング言語の一種である XML (拡張マークアップ言語) を使用して通信します。これらは、 2000年代初期に異なるソフトウェア アプリケーション間で通信するための標準化されたアプローチでした。それ以来、REST や GraphQL などの 代替手段と比較して より複雑で柔軟性に欠けるため、人気は大幅に低下しています。
APIの種類
API は 4 つの方法で分類され、それぞれに独自のユーザーと権限があります。
オープンAPI
これらは、開発者がプラットフォームのサービスやデータにアクセスできるようにするパブリック API です。サードパーティのインテグレーションにもアクセス可能です。以下にいくつかの例を示します。
Google Maps API:誰でもこの API を使用して Google マップをアプリに統合し、マッピングや位置情報ベースのサービスにアクセスできるようになります。
Notion API:このオープン API を使用すると、ユーザーは Notion ワークスペースを他のソフトウェアに接続できます。Notion は、コード不要のソリューションを実現するためにZapier とも統合されています。
オープンAI API:この API を使用すると、開発者は GPT- 4 o API と Whisper API を他のアプリに接続できます。ZapierのChatGPTインテグレーションを使用してこれらのモデルに接続することもできます。
Discord API:この API を使用して、Discord チャンネルを外部アプリと統合できます。コード不要のオプションとしては、 Zapier の Discord インテグレーションをお試しください。
REST 国 API:このオープンソース API は、国旗、通貨、人口統計などの国に関する詳細情報へのアクセスを提供します。
パートナーAPI
これは、パートナーまたは選択されたサードパーティエンティティ向けに作成された API の一種です。これらは、多くの場合、プラットフォームとそのパートナー間のインテグレーションのために、特定の機能またはデータへの制限付きアクセスを提供します。以下にいくつかの例を示します。
Facebook ログイン API: サードパーティアプリケーションはこのAPIを使用して、Facebookの資格情報によるユーザー認証を有効にし、簡単にログインできるようになります。
Airbnb パートナー API:外部の予約システムやその他のシステムを統合するこの API を実装するために、Airbnb のパートナー マネージャーが将来のパートナーに直接連絡を取ります。
eBay API: eBay は、eBay 開発者プログラムに参加するユーザーに、販売 API、購入 API、コマース API など、さまざまな API を提供しています。
Shopify パートナー API:この API は、Shopify アプリを他の製品と接続できるようにし、たとえば、SaaS メトリクス ツールが Shopify ダッシュボードから直接データを取得できるようにします。
内部API
これらはプライベート API とも呼ばれ、組織が内部目的で作成および使用します。内部システム間の通信とデータ共有を容易にします。これらはプライベートまたは独自のプロセスの一部であるため、一般的には公知ではありません。以下にいくつかの例を示します。
Amazon API: Amazon の従業員は社内 API を通じてのみデータを共有し、長年にわたる拡張に役立っています。
Target API:多くの小売業者 (Target を含む) が内部 API を使用して、店舗全体の在庫レベル、製品の在庫状況、その他の情報を追跡しているため、ここでは小売業者に関するパターンが見られます。
Netflix API: Netflix はプライベート API を使用して、プラットフォーム、ストリーミング ライブラリ、コンテンツ推奨アルゴリズムを数百種類のデバイスからアクセスできるようにしています。
複合API
複合 API はオーケストレーション API とも呼ばれ、複数の API からのデータまたは機能を統合します。これらはクライアントの単一のエントリ ポイントとして機能し、統合されたインターフェイスによって複数の API とのやり取りの複雑さを簡素化します。以下にいくつかの例を示します。
Twilio API:この API は複数の通信チャネルを統合し、ユーザーが包括的な通信ソリューションを構築できるようにします。
Salesforce 複合 API:この API は、1 回の呼び出しで複数の Salesforce API リクエストを実行します。
Kayak API: Kayak などの旅行予約サイトでは、複合 API を使用して、複数の航空会社、ホテル、レンタカー会社から価格データを一度に取得します。
API は革新的なアプリやサービスを作成するための無限の案件をもたらします。ただし、API を使用してアプリを統合したり、ワークフローを自動化したりしたいだけの場合は、コーディングを省略し、Zapier を使用して、ソファに座ったまま任意のアプリを接続できます。
Zapierは、アプリを自動化されたワークフローに接続して、すべての人と企業が成長速度で前進できるようにするノーコードの自動化ツールです。その仕組みの詳細については、こちらをご覧ください。
API を使用する理由は何ですか?
API がなければ、実際にどこかへ行くには紙の地図を使わなければなりません (そして私は100 % の確率で道に迷うでしょう)。API を使用すると、車輪の再発明をすることなく、既存のソースからデータにアクセスできます。したがって、お気に入りのナビゲーションアプリを使用するとき、実際には携帯電話の基地局と全地球測位システム (GPS) に位置データへのアクセスリクエストを送信していることになります。
ソフトウェア開発側では、API はショートカットを提供し、開発者が事前に構築された機能を活用できるようにするため、新しい機能の構築に集中できます。たとえば、 Plane Finder は飛行機をリアルタイムで追跡します。彼らは、独自の世界地図の作成に時間を費やす代わりに、Google Maps API を使用することで、他の機能に時間を費やすことができました。
API はさまざまなシステム間のインテグレーションも容易にし、アプリ間でシームレスなデータ交換を可能にします。これは、 CRM を電子メールに接続するなど、企業がアプリ間で情報を共有する必要がある場合に便利です。
Zapier を使ってコーディングなしでアプリを接続
API を使用してアプリをブリッジする技術的な詳細を見てきましたが、Zapier を使用すると、コードを一行も書かずに同じ連携を作成できます。APIキーを探してリクエストを書く代わりに、Zapier を使用すると、職場で使用するアプリのアクティビティに基づいてアクションを自動的にトリガーできます。
Zapier は8 、 000以上のアプリと即座に統合されるため、テクノロジー スタック内のすべてのアプリを接続できます。つまり、API の設定やAPI連携のテストに費やしていた時間を、よりエキサイティングなプロジェクトに取り組んだり、新しい案件を見つけたり、何十ページものAPIドキュメントを読む必要のないあらゆるプロジェクトに集中したりするために使うことができるのです。Zapier の使用を開始する方法、または構築を開始する方法について詳しくご覧ください。
APIに関するよくある質問
コード、データ、サーバーに関わるものと同様、開発者でなければ API を理解するのは難しい場合があります。しかし、ここまで成功すれば、調子はいいよ。長引く質問への回答については、続けて読んで。
MCP と API の違いは何ですか?
API はアプリケーションやデータ ソースを接続するために使用される一般的なテクノロジですが、 MCP (AIモデル コンテキスト プロトコル) は、特に AI モデルを外部データ ソースやその他のツールに接続するために使用されます。MCP は、 LLM にAPI へのアクセスを提供するプロトコルと考えてください。
初心者に最適な API はどれですか?
チュートリアルで設定したGmail API は、最も簡単に始められるものの 1 つですが、初心者向けの他のオプションとしては、 Google Maps API 、 OpenWeather API 、 JSONPlaceholder (学習とテストのために構築されています) などがあります。これらの API にはそれぞれ明確なドキュメントがあり、API キーを必要としないか、シンプルなキーベースの認証を備えています。
API からデータにアクセスするにはどうすればよいですか?
API は、ユーザーが検索することなくサーバーからデータにアクセスするために使用されます。ただし、データをさらに詳しく確認したい場合 (つまり、マトリックスを参照したい場合)、選択した API への開発者アクセス権が必要になる可能性があります。Zapierを使用すると、ノーコードでAPIからデータにアクセスすることもできます。
独自の API を作成できますか?
アプリケーションを作成し、そのアプリのデータを他のユーザーに安全に公開するためのコーディング知識がある場合は、独自のAPIを作成できます。これには、既存のAPIを使用してアプリを接続するよりもはるかに多くの労力が必要ですが、それを実行する能力があれば、さらに強力になります。
4種類の API とは何ですか?
最も一般的な 4 つの API タイプは、オープン、パートナー、プライベート、複合です。オープン API は一般の人がアクセスできます。パートナー API にアクセスできるのは、選択されたユーザーまたはチームのみです。プライベート API は企業内で使用されます。複合 API は複数の API を 1 つの統合インターフェースにまとめます。各タイプの詳細と例については、 前のセクションまでスクロールしてください。
APIとは何ですか?
APIは、さまざまなアプリを接続して通信やデータの交換を可能にするアプリケーションプログラミングインターフェースです。携帯電話やコンピューターを使用している場合（実際に使用しています）、おそらく、気づかないうちに常に API を操作していることになります。
自分で実装したい場合は、まず公開 API を見つけて、コーディングの知識を磨く必要があります。視覚的な例を交えたステップバイステップの手順については、上記のガイドをご覧ください。
関連記事:
この記事は、 2023年 7 月に Cecilia Gillen によって最初に公開されました。ディラン・リーバーの寄稿による最新の更新は、 2025年7月でした。
