API

APIとは？

API、つまりApplication Programming Interfaceは、異なるソフトウェアアプリケーション同士が会話できるようにするメッセンジャーのようなものです。 2つのプログラムをつなぎ、同じシステムでなくても情報を交換して連携できるようにする橋のようなものだと考えてください。

技術的には、APIは、あるプログラムが別のプログラムに情報やサービスを要求する方法を定義する一連のルールです。これらのルールは次のことを定義します：

• どの情報を要求できるか

• どのように要求するか（特定のコマンドを通じて）

• 情報が返送されるときにどの形式であるべきか

APIはどのように機能するのか？現実世界のたとえ

APIの仕組みを理解する簡単な方法は、次の図に示されたリクエストとレスポンスのサイクルを表すレストランでの現実のシナリオと比較することです。

• 顧客がウェイターを通じて注文（リクエスト）を行います。

• ウェイターはその注文をキッチン（サーバー）に持っていきます。

• シェフ（サーバー）が料理（データ）を準備します。

• ウェイター（API）が準備された料理（レスポンス）を顧客に持ち帰ります。

図- APIの現実世界のたとえ.png

図：APIの現実世界のたとえ

1. 顧客（Web経由で操作するユーザー）：顧客は、Webサイトやアプリを操作しているあなた、または任意のユーザーを表します。キッチン（サーバー）がどのように機能するかの詳細を知る必要はありません。メニューから料理を選ぶように、単にリクエストを行うだけです。

2. ウェイター（API）：ウェイターがAPIです。ウェイターの仕事は、顧客のリクエスト（注文など）を受け取り、それをキッチンに届けることです。APIはウェイターと同じように、あなた（顧客）とサーバー（シェフまたはキッチン）の間のメッセンジャーとして機能します。ウェイターがシェフと話す方法を知っているのと同じように、APIはサーバーと通信する方法を正確に知っています。

3. シェフ（アプリケーションサーバー）：キッチンにいるシェフはアプリケーションサーバーです。シェフは料理を準備し（リクエストを処理し）、準備された料理を顧客に返すウェイター（API）に渡します。同様に、サーバーはあなたのリクエストを処理し、関連するデータをAPIに送り返します。

実用的な例として、天気アプリを使って自分の都市の予報を確認する場合があります。アプリ自体が天気データを生成するのではなく、APIを通じて天気サービスにリクエストを送信します。APIは天気サービスと通信し、データを取得して、それをアプリに送り返し、ユーザーフレンドリーな形式で表示します。

APIのさまざまな種類

API（Application Programming Interfaces）には、設計、用途、通信スタイルによって分類されるいくつかの種類があります。最も一般的な種類は次のとおりです：

1. Web API（HTTP API）

Web APIは、HTTPまたはHTTPSを使用してインターネット上のサーバー間の通信を可能にします。最も一般的なAPIの種類です。

• REST（Representational State Transfer）: HTTPメソッド（GET、POST、PUT、DELETE）を使用し、ステートレスである一般的なWeb APIの種類です。REST APIはURLエンドポイントを使用してリソースにアクセスし、そのシンプルさとスケーラビリティにより広く採用されています。一般的なREST API用語には次のものがあります：

• エンドポイント： エンドポイントとは、APIにアクセスするためのURLです。操作したいリソースを指定します。たとえば、https://api.weather.com/forecastは天気データを取得するためのエンドポイントです。

• メソッド： メソッドは、APIで実行できるアクションを定義します。一般的なメソッドには次のものがあります：

  • GET： データを要求する（例：天気情報を取得する）。

  • POST： データを送信する（例：フォームを送信する）。

  • PUT： 既存のデータを更新する（例：ユーザー情報を変更する）。

  • DELETE： データを削除する（例：データベースから項目を削除する）。

• APIキー： APIキーは、APIへのリクエストを認証するために使用される一意の識別子です。APIを通じて特定のデータやサービスにアクセスすることが許可されていることを証明するパスワードのようなものだと考えてください。

• GraphQL: クライアントが必要なデータだけを正確にリクエストできる、API向けのクエリ言語。複数のエンドポイントが必要になる場合があるRESTとは異なり、GraphQLでは1回のリクエストで複数のリソースを取得できます。

• SOAP (Simple Object Access Protocol): メッセージのフォーマットにXMLを使用する、プロトコルベースのAPI。RESTよりも厳格で安全性が高く、高い信頼性を必要とするエンタープライズレベルのアプリケーションでよく使用されます。

• JSON-RPC and XML-RPC: JSONまたはXMLを使用してデータをエンコードするリモートプロシージャコール（RPC）プロトコル。RPC APIはRESTよりもシンプルですが、柔軟性や普及度では劣ります。

2. ライブラリベースのAPI

これらのAPIは、開発者がアプリケーションに統合するプログラミングライブラリを通じて機能を公開します。ネットワーク通信に基づくものではなく、ソフトウェア依存関係に基づいています。

• 言語固有のAPI: 特定のプログラミング言語（例: Python、Java、またはJavaScript API）で利用可能で、特定の言語またはフレームワーク内でタスクを実行するための事前構築済みの関数を提供します。

• フレームワーク固有のAPI: Python向けのDjangoやFlask、Java向けのSpringなど、特定のフレームワーク向けに設計されたAPIで、特定の機能を抽象化することにより、開発者がアプリケーションをより迅速に構築できるよう支援します。

3. オペレーティングシステムAPI

これらはアプリケーションがオペレーティングシステムとやり取りできるようにし、ファイルシステム、メモリ、ハードウェアデバイスなどのシステムリソースへのアクセスを提供します。

• Windows API: 開発者がWindows OSとやり取りできるようにし、ファイル操作、ネットワーキング、プロセス管理などのタスクを処理します。

• POSIX API: Unixベースのオペレーティングシステムで使用され、プロセス、スレッド、ファイル管理のための標準インターフェースを提供します。

4. データベースAPI

これらのAPIは、アプリケーションがデータベースと通信して、クエリの実行、レコードの更新、トランザクションの管理を行えるようにします。

• JDBC (Java Database Connectivity): Javaアプリケーションがデータベースに接続し、SQLクエリを実行するためのAPI。

• ODBC (Open Database Connectivity): 使用されるデータベース管理システムに関係なく、アプリケーションがデータベースとやり取りするための標準的な方法を提供します。

• NoSQL APIs: MongoDB、Cassandra、ElasticsearchなどのNoSQLデータベースに固有のAPIで、SQLベースのデータベースとは異なる方法でデータを扱います。

5. クラウドAPI

クラウドAPIはクラウド内のサービスへのアクセスを提供し、アプリケーションがストレージ、コンピューティング、ネットワーキングなどのリソースを活用できるようにします。

• AWS SDK/API: Amazon Web Servicesは、EC2（コンピューティング）、S3（ストレージ）、Lambda（サーバーレス）などのクラウドサービスとやり取りするためのAPIを提供しています。

• Google Cloud APIs: BigQuery、Compute Engine、Kubernetes EngineなどのGoogle Cloudサービスへのアクセスを提供します。

• Azure APIs: Microsoft Azure APIsは、クラウドベースのインフラストラクチャ全体でアプリケーションを構築および管理するためのサービスを提供します。

6. ハードウェアAPI

これらのAPIは、ソフトウェアがハードウェアコンポーネントと直接通信できるようにします。

• DirectX: Microsoft環境におけるマルチメディア、ゲーム、ビデオに関連するタスクを処理するためのAPIの集合。

• OpenGL: 2Dおよび3Dベクターグラフィックスのレンダリングに使用されるAPIで、ビデオゲームや可視化ツールで広く使用されています。

• デバイス固有のAPI: モバイルデバイスや組み込みデバイスにおけるカメラ、センサー、GPSなどのハードウェア機能へのアクセスを可能にします（例: モバイルハードウェア向けのiOSおよびAndroid API）。

7. 内部/プライベートAPI

これらのAPIは組織内での使用を目的として設計されており、一般には公開されません。内部システムやアプリケーション間の通信を容易にします。

• 内部サービスAPI: 組織のインフラストラクチャ内のマイクロサービスや異なるコンポーネントが相互に通信するために使用されます。

8. パブリック/外部API

これらのAPIは、外部の開発者がサードパーティサービスと統合できるように公開されています。

• ソーシャルメディアAPI: Facebook、Twitter、LinkedInなどのソーシャルプラットフォームの機能にアクセスするためのもの（例：投稿、データの取得、ユーザープロフィールの管理）。

• 決済API: PayPal、Stripe、Squareなどのサービスは、取引、サブスクリプション、請求書発行を処理するためのAPIを提供しています。

9. パートナーAPI

これらのAPIは、通常、管理された限定的な環境の下で特定のビジネスパートナーと共有され、プライバシーとセキュリティを維持しながらコラボレーションと統合を可能にします。

10. コンポジットAPI

コンポジットAPIは、複数のAPIを1回の呼び出しにまとめることで、複数のリクエストの必要性を減らし、効率を向上させます。これらは、複数のサービスを集約する必要があるマイクロサービスアーキテクチャで一般的に使用されます。

各タイプのAPIは特定の目的を果たし、その使用方法はアプリケーションのニーズと、それが動作する環境によって異なります。

APIの実践的な例

あなたはおそらく、気づかないうちに毎日APIを使っています。以下は日常的な例です。

• GoogleまたはFacebookでログインする: 多くのウェブサイトでは、GoogleまたはFacebookアカウントを使用してログインできます。このオプションを選ぶと、ウェブサイトはAPIを使用してGoogleまたはFacebookにあなたのアカウント情報を（あなたの許可を得て）要求するため、新しいアカウントを作成する必要がありません。

• 天気を確認する: 天気アプリを使用するとき、そのアプリはおそらく天気APIを使用して、気象データ提供元から最新の予報を取得しています。

• オンラインで支払いを行う: eコマースサイトで支払いを行うとき、APIはストアとPayPalやStripeなどの決済処理業者を接続し、取引を安全に完了させます。

APIのメリット

統合を簡素化する

APIにより、開発者が既存のコードを書き直す必要なくシステム同士を連携させることができ、外部サービスを活用してアプリケーションに新機能を簡単に追加できます。

再利用性を促進する

すべてをゼロから構築する代わりに、開発者はAPIを使用して、決済処理、メールサービス、ユーザー認証などの一般的に使用される機能を統合できます。

開発時間を短縮する

APIは、開発者がアプリケーションに組み込める事前構築済みの機能を提供することで、開発を加速します。これにより、複雑な機能の開発に必要な時間と労力が削減されます。

比較: API vs. SDK

APIとSDKは一緒に言及されることが多いものの、ソフトウェア開発において異なるが補完的な役割を果たします。以下は、APIとSDKの主な違いの一部です。

機能	API (Application Programming Interface)	SDK (Software Development Kit)
定義	アプリケーション同士が通信する方法を提供し、多くの場合 Web 経由で行われます。	開発者が特定のプラットフォーム向けにアプリケーションを作成するのに役立つツールセット。
構成要素	通信ルール、エンドポイント、リクエスト/レスポンス処理に重点を置きます。	API、開発ツール、コンパイラ、デバッガ、場合によってはハードウェアシミュレータを含みます。
用途	外部サービスやデータにアクセスするために使用されます（例：位置情報サービス向けの Google Maps API）。	アプリケーション全体をゼロから構築するために使用されます（例：Android アプリ構築向けの Android SDK）。
複雑さ	通常、より軽量で範囲がより具体的です（通信に重点）。	通常、より包括的で、アプリケーション開発向けのさまざまなツールを提供します。
例	ツイートへのアクセスおよび投稿のための Twitter API。	iPhone アプリ開発向けの iOS SDK。
プラットフォーム依存性	一般的にプラットフォーム非依存で、特に Web API が該当します。	通常、プラットフォーム固有です（例：Apple 向けの iOS SDK、Android 向けの Android SDK）。

表: API と SDK

Milvus/Zilliz API: ベクトル検索と AI アプリケーションを支える

画像、動画、音声ファイルのような大量の非構造化データを扱う場合、従来のデータベースはこれらを効率的に処理するようには設計されていません。そこでベクトルデータベースが登場します。

Milvus や Zilliz Cloud（マネージド Milvus）などのベクトルデータベースは、ベクトル埋め込みと呼ばれる数値表現の形式で非構造化データを効率的に保存、インデックス化、取得するデータベース管理システムの一種です。これらは通常、埋め込みモデルによって作成され、非構造化データの意味的な関係を捉えることができます。

Milvus ****は、パフォーマンスを重視して構築されたオープンソースのエンタープライズレベルのベクトルデータベースです。超低レイテンシで十億規模のベクトルを処理できます。さまざまな要件やニーズに対応した各種 API を提供しています。

• RESTful API: Milvus は、開発者がベクトルデータベースに保存されたコレクションやデータを操作できる RESTful API を提供しています。この API は、コレクションの作成、一覧表示、クエリなどのタスクや、ベクトルデータの管理のためのエンドポイントを提供します。

• Client SDKs: Milvus は、Python (PyMilvus)、Java、Go、C#、Node.js など、さまざまなプログラミング言語向けのクライアントライブラリを提供しています

これらの API により、開発者はコレクションの作成、データの挿入、ベクトルの検索、インデックスの管理など、Milvus 上でさまざまな操作を実行できます。API の選択は、具体的なユースケースと好みのプログラミング言語によって異なります。

Zilliz Cloud は、オープンソースの Milvus ベクトルデータベースのフルマネージド版です。前述の RESTful API と、Milvus が提供する Client SDKs を共有しています。Zilliz Cloud はさらに、クラスター、コレクション、およびそれらに保存されたデータを操作するための追加の API グループも提供しています。

• Control Plane APIs:

  • Cloud Meta

  • Cluster Operations

  • Import Operations

  • Pipeline Operations

ユースケース例: AI 搭載画像検索

RESTful API を使用して AI 搭載画像検索を構築する例を見てみましょう。

ユーザーが画像をアップロードし、視覚的に類似した画像を見つけるアプリケーションを構築しているとします。これには画像のベクトル表現の比較が含まれ、各画像はベクトル埋め込み（特徴を数値で表したもの）に変換されます。RESTful API を使用すると、次のことができます:

• これらの画像ベクトルを保存するためのコレクションを作成する。

• コレクションにベクトルを挿入する。

• ベクトル類似度に基づいて類似画像を取得するためにコレクションをクエリする。

以下のコードは、Zilliz Cloud REST API とやり取りして、ベクトルデータベース内のベクトルデータを管理する方法を示しています。これには、128 次元の画像ベクトルを保存するためのコレクションの作成、画像を表すベクトルの挿入、そしてベクトル類似性検索を実行してユークリッド距離に基づいて最も類似した画像を見つける、という 3 つの主要な操作が含まれています。

import requests
import json

# Replace with your Zilliz Cloud API information
API_KEY = 'your_api_key'  # Your Zilliz Cloud API Key
ZILLIZ_ENDPOINT = 'https://your-cluster-id.api.your-cloud-region.zillizcloud.com/v1/vector'
HEADERS = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json',
    'Accept': 'application/json'
}

# Step 1: Create a collection to store image vectors
def create_image_collection():
    url = f"{ZILLIZ_ENDPOINT}/collections/create"
    payload = {
        "collectionName": "image_collection",
        "dimension": 128,  # Example vector dimension for images
        "metricType": "L2",  # Euclidean distance for similarity
        "primaryField": "id",
        "vectorField": "embedding"
    }
    response = requests.post(url, headers=HEADERS, json=payload)
    print("Create Collection Response:", response.json())

# Step 2: Insert image vectors into the collection
def insert_image_vectors():
    url = f"{ZILLIZ_ENDPOINT}/insert"
    payload = {
        "collectionName": "image_collection",
        "data": [
            {
                "id": 1,
                "embedding": [0.12, 0.34, 0.56, 0.78] * 32  # Example 128-dimensional vector
            },
            {
                "id": 2,
                "embedding": [0.22, 0.44, 0.66, 0.88] * 32  # Another example vector
            }
        ]
    }
    response = requests.post(url, headers=HEADERS, json=payload)
    print("Insert Image Vectors Response:", response.json())

# Step 3: Search for similar image vectors
def search_similar_images():
    url = f"{ZILLIZ_ENDPOINT}/search"
    payload = {
        "collectionName": "image_collection",
        "limit": 1,  # Retrieve top 1 similar image
        "vector": [0.12, 0.34, 0.56, 0.78] * 32  # Query vector for search
    }
    response = requests.post(url, headers=HEADERS, json=payload)
    print("Search Similar Images Response:", response.json())

# Execute the functions
create_image_collection()
insert_image_vectors()
search_similar_images()

FAQs

1. API とは簡単に言うと何ですか？

API（Application Programming Interface）は、2 つの異なるアプリケーションが互いに通信できるようにするメッセンジャーのようなものです。データ共有を目的として、あるプログラムが別のプログラムから情報やサービスを要求する方法について、ルールとプロトコルを定義します。

2. API は開発者にどのようなメリットをもたらしますか？

APIは、決済処理やソーシャルメディア機能などの既存の機能を、ゼロから構築することなくアプリに統合できるようにすることで、開発者の時間を節約します。これにより、コードの再利用性が促進され、複雑なタスクが簡素化され、開発プロセスが高速化されます。

3. APIとSDKの違いは何ですか？

APIは、通常Web上で、アプリケーション同士が通信できるようにします。一方、SDK（Software Development Kit）は、開発者が特定のプラットフォーム向けにアプリケーションを作成するのを支援するツール、ライブラリ、ドキュメントの集まりであり、多くの場合、ツールキットの一部としてAPIが含まれています。

4. APIにおけるRESTとは何ですか？

REST（Representational State Transfer）は、ネットワーク化されたアプリケーションを設計するためのアーキテクチャスタイルです。REST APIはHTTPリクエストを使用して、データの取得（GET）、データの送信（POST）、データの更新や削除などの操作を実行します。そのシンプルさと柔軟性により広く使用されています。

5. GraphQLはRESTとどう違いますか？

GraphQLは、RESTと比較してより柔軟なクエリ言語です。GraphQLでは、クライアントが必要なデータを正確に指定できるため、転送されるデータ量を削減できます。RESTでは、クライアントは必要なのが一部だけであっても、エンドポイントからすべてのデータを受け取ることが多く、そのため一部のユースケースではGraphQLの方が効率的です。

6. APIキーとは何で、なぜ重要なのですか？

APIキーは、APIリクエストを認証し追跡するために使用される一意の識別子です。認可されたユーザーのみがAPIにアクセスできるようにし、使用状況を監視できるようにするため、アクセス制御と機密データの保護に不可欠です。

7. APIにおけるレート制限とは何ですか？

レート制限は、ユーザーが特定の期間内に行えるAPIリクエスト数を制限する制御メカニズムです。これにより、過剰なリクエストによってAPIサーバーが圧迫されるのを防ぎ、すべてのユーザーに公平な利用を保証し、全体的なパフォーマンスと信頼性を向上させます。

関連リソース

• Zilliz Cloud RESTful API

• Zilliz REST API入門

• Milvusとは？

• Zilliz Cloud vs Milvus

• Langchain Community APIの探究：MilvusとZillizによるシームレスなベクトルデータベース統合

• OpenAI Embedding APIをZilliz Cloudと統合する方法