アプリケーションプログラミングインタフェース (API) の説明

Objectives

After completing this lesson, you will be able to:
  • API とそのニーズについて説明します。
  • API の利点を特定します。
  • API の構造を分析します。

API のビジネスイントロダクション

ビジネスをインテリジェントで持続可能な企業に変換する際に、いくつかの課題に直面する場合があります。たとえば、クラウドベースまたはハイブリッドベースのシステムの多様なランドスケープで、アプリケーションとビジネスプロセスを統合する必要があります。また、非 SAP サプライヤからのソリューションもあります。その場合、SAP プロセスから非 SAP プロセスに統合する必要があります。SAP Integration Suite を使用して、SAP を SAP プロセスに統合し、非 SAP プロセスを SAP に統合することができます。会社は、SAP Integration Suite を使用して API を商品化および管理することもできます。

API の概要

API は、"アプリケーションプログラミングインタフェース" の頭字語です。これは、アプリケーション/Web サイトとユーザ間のメディエータ (ソフトウェアによって表される) です。そのため、異なるインスタンス間の通信で情報を交換することが不可欠です。

API プロセスの視覚化。

API が実現されずに、日常生活で発生します。たとえば、Google 検索: 検索バーに何かを入力するたびに、Google のバックエンドサービスがデータベースでキーワードを検索し、要求の結果を Web サイトに一覧表示します。実は、ウェブサイトにはAPIの結果が表示される。このインジケータは、各検索の URL です。

"SAP" を検索すると、URL: www.google.com/search? が表示されます。q=sap

ここで、これをスライスします。

ここで www.google.com はサーバアドレスで、/search は使用する予定の機能を示します。つまり、呼び出す API は Google Search API であり、q (クエリ) はクエリの値が引き渡されたことを示します。これが検索語句です。

SAP のヘルプページ (https://help.sap.com) についても同様です。検索バーに API と入力すると、URL https://help.sap.com/docs/search? が表示されます。q=api

ただし、API 呼出が必ずしもコンピュータによって開始される必要はありません。Voice Assistance システムは、API の統合と使用の例でもあります。音声アシスタントに何かを検索するよう依頼すると、実際にアシスタントにクエリが提供されます。このクエリはテキストとして保存され、クエリとして API 呼び出しに追加されます。その後、アシスタントは音声音声を使用して API の結果を提供します。

そのため、接続されているデバイスのいずれを使用しても、気づくことなく 1 時間ごとに複数の API を使用しています。API は汎用的で、ユーザと開発者が "どのように" 実行する必要のある "何を" 集中できるようにするため、API がこのような重要なトピックであるのはこのためです。また、WhatsAppメッセージがどのように受信者に送信されるかを考えたことがありますか?

したがって、名前が示すように、API は、音楽の再生など、特定の機能をトリガするために使用される多くのタイプのインタフェースの 1 つにすぎません。マウス/タッチスクリーンを使用してアプリケーション/Web サイト間をナビゲートするために使用する GUI (グラフィカルユーザインタフェース) など、他のタイプのインタフェースにすでに精通している場合があります。

API の利点

API の必要性

現在、API は IT アーキテクチャに不可欠です。フロントエンドからバックエンドへのアクセス、インタフェース管理、ポイントツーポイント通信は、長年にわたって IT アーキテクチャーのかなりの部分を占めていますが、API はアプリケーションや Web サイトの通信方法に革命をもたらしてきました。そのため、API は IT ランドスケープの構築と管理に多くのメリットをもたらしています。最も重要なもの、ひいては企業が IT アーキテクチャに導入する必要がある主な理由は、以下のとおりです。

API の利点の一覧

API は、その中核で、タスクから通信を分離します。したがって、サービスが API を介して通信する場合、API のユーザ (またはコンシューマ) は、API が提供する機能に完全に焦点を当てています。ユーザーは、ジョブ自体を考慮せずに API の機能のみを使用します。焦点は、要求と結果 (応答) に基づいており、それ以外にはありません。

API の構造

API タイプ

API の定義および実装には、さまざまなグローバル標準を使用することができます。これらのいくつかを以下に示します (ただし、最も一般的に使用されるのは REST API です)。

共通 API タイプ

最も一般的な API タイプとして REST API を使用する場合は、REST API 機能を簡単に詳しく説明します。API を使用するときは、通常、リソースについて話します。これは、通常、以下のいずれかを実行することを意味します。

  • 何かを作成します (ゲストブックへの新規エントリの追加など)。
  • API から何かを読んだり、入手したりします (Google 検索を覚えておいてください。ここで Web サイトの一覧を取得しようとしました)。
  • 何かを更新または変更します (通常、何らかのステータスやタイプミスなど、変更が必要なものを作成した場合)。
  • 削除を実行します。

これらのアクションを併せて、CRUD と略します。

REST API の場合、これらの動詞は CRUD 動詞とよく似ています。

CRUD と REST 動詞の比較

CRUDREST
読込GET
登録POST
更新PUT/PATCH
削除削除

"update" には、PUT と PATCH の 2 つの動詞があります。

パッチを適用することで、参照しているリソースの一部のみが変更されます。ある単語だけを修正し、ワード番号 42 を交換する必要があることをゲストブックに通知するゲストブックのエントリについて考えてみてください。これは、パッチ (修復または変更に関するスポット) です。一方、PUT は、ほぼ同じであってもテキスト全体が変更されますが、エラーが修正されました (テキスト全体をクリアし、すべてを再度ペーストすることを考えてください)。

通常、API の仕様を確認すると、これらの動詞は以下のように表示されます (SAP BTP Integration Suite のデプロイメント例から取得されます)。API は、必ずしもすべての動詞をサポートするわけではありません。

API 動詞

このレッスンの重要ポイント

アプリケーションプログラミングインタフェース (API) により、アプリケーションとの通信とデータ交換が可能になります。API を使用することで、人的労力を削減し、コストを削減し、システム統合を以前よりも大幅に迅速化することができます。API の定義と実装にはいくつかのタイプがありますが、最も一般的なタイプは REST API です。