API request

/ˌeɪ.piːˈaɪ rɪˈkwest/ エーピーアイ リクエスト

1. アプリケーションプログラミングインターフェース（API）に対して行われる、データや機能へのアクセスを求める要求のこと。

ソフトウェアやシステムが、別のソフトウェアやサービスが提供する機能やデータにアクセスするために送信するコマンドやメッセージを指します。例えば、あるウェブサイトが天気予報アプリから天気情報を取得する際に、「今日の東京の天気予報を教えて」という形で送られるのがAPIリクエストです。

We need to send an API request to the server. (私たちはサーバーにAPIリクエストを送信する必要があります。)

• We: 複数の人を含む「私たち」を指します。
• need to: 「～する必要がある」という必要性を示します。
• send: 何かをある場所から別の場所へ移動させる行為を表します。
• an API request: ソフトウェア間で行われる、機能やデータへのアクセス要求を指します。
• to the server: ネットワーク上でサービスを提供するコンピューターやシステムに対して、という方向を示します。

The application sends an API request to retrieve user data. (そのアプリケーションはユーザーデータを取得するためにAPIリクエストを送信します。)

• The application: 特定の目的のために設計されたソフトウェアプログラムを指します。
• sends: 「送る」という行為で、データや情報を転送することを意味します。
• an API request: アプリケーションが別のサービスから情報を取得したり、機能を実行したりするために出す要求です。
• to retrieve: 失われたり保存されたりしたものを「取り戻す」「検索して取得する」ことを指します。
• user data.: 利用者の個人情報や行動履歴などの情報を指します。

Each API request must include an authentication token. (各APIリクエストには認証トークンを含める必要があります。)

• Each: 個々の要素を一つずつ指し、「それぞれの」という意味です。
• API request: アプリケーション間の情報交換で使われる、特定の機能やデータへのアクセス要求を指します。
• must: 「～しなければならない」という強い義務や必要性を示します。
• include: 何かがその中に「含まれている」状態を表します。
• an authentication token.: 身元を確認するための、秘密のコードや情報のかたまりを指します。

2. プログラミングにおいて、特定のAPIエンドポイントに対して情報を要求すること。

開発者が自身のアプリケーションに外部の機能やデータを組み込む際に、その外部サービスに対して特定のフォーマットで情報を要求するプロセス全体を指します。例えば、地図アプリが現在地に基づいて近くのレストラン情報を表示するために、レストランデータベースAPIに「この場所の近くのレストランを教えて」と尋ねる行為がこれにあたります。

Developers often use API requests to integrate third-party services. (開発者はサードパーティのサービスを統合するためにAPIリクエストをよく使用します。)

• Developers: ソフトウェアやアプリケーションを開発する人々を指します。
• often use: 「よく使う」という、頻繁に行われる行為を表します。
• API requests: プログラミングにおいて、アプリケーションが他のサービスやシステムと連携するために送信する命令です。
• to integrate: 複数の異なる要素を一つに「統合する」「組み合わせる」ことを意味します。
• third-party services.: 自社のサービスではない、他社が提供するサービスや機能を指します。

Before making an API request, you should check the documentation. (APIリクエストを行う前に、ドキュメントを確認すべきです。)

• Before making: 何かを行う「前に」というタイミングを示します。
• an API request,: プログラムが外部サービスに情報を求める前に、という意味です。
• you: 話している相手や対象となる人を指します。
• should: 「～すべきである」という助言や推奨を表します。
• check: 何かを「確認する」「調べる」という行為です。
• the documentation.: 製品やサービスの利用方法、機能などが詳細に記述された書類を指します。

Failed API requests can indicate a network issue. (失敗したAPIリクエストはネットワークの問題を示す可能性があります。)

• Failed: 目的を達成できなかった、成功しなかった状態を表します。
• API requests: 外部サービスへの接続や情報の取得がうまくいかなかった要求を指します。
• can indicate: 何かを示す可能性や兆候があることを意味します。
• a network issue.: コンピューター同士やサーバーとの通信に問題がある状態を指します。

関連

• API call
• Web service
• Endpoint
• JSON
• REST
• HTTP request