📣
TiDB Cloud Premium はパブリックプレビュー中です。エンタープライズワークロード向けの無制限のスケーリング、即時の弾力性、高度なセキュリティを提供します。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者
ベストプラクティス
API

Postmanでデータアプリを実行する

PostmanAPI ライフサイクルを簡素化し、コラボレーションを強化してより迅速で優れた API 開発を実現する API プラットフォームです。

TiDB Cloud Data Serviceでは、データアプリをPostmanに簡単にインポートし、Postmanの豊富なツールを活用してAPI開発体験を向上させることができます。

このドキュメントでは、データアプリをPostmanにインポートする方法と、Postmanでデータアプリを実行する方法について説明します。

始める前に

Postmanにデータアプリをインポートする前に、以下のものを用意してください。

  • Postmanアカウント

  • Postmanデスクトップアプリ(オプション)。あるいは、アプリをダウンロードせずに Postman Web バージョンを使用することもできます。

  • 明確に定義された終点が少なくとも 1つあるデータアプリ。次の要件を満たすエンドポイントのみを Postman にインポートできます。

    • 対象のTiDB Cloud Starterインスタンスが選択されました。
    • エンドポイントパスとリクエストメソッドが設定されました。
    • SQL文が記述されました。

  • データアプリ用のAPIキー。

ステップ1. データアプリをPostmanにインポートする

データアプリをPostmanにインポートするには、以下の手順に従ってください。

  1. TiDB Cloudコンソールで、プロジェクトのData Serviceページに移動します。

  2. 左側のペインで、対象のデータアプリの名前をクリックすると、その詳細が表示されます。

  3. ページ右上隅にあるRun in Postmanをクリックします。インポート手順が表示されたダイアログが表示されます。

  4. データアプリのインポートに関するダイアログに表示される手順に従ってください。

    1. お好みに応じて、 Run in Postman for WebまたはRun in Postman Desktopを選択してPostmanワークスペースを開き、次に目的のワークスペースを選択してください。

      • Postmanにログインしていない場合は、画面の指示に従ってまずPostmanにログインしてください。
      • Run in Postman Desktopをクリックした場合は、画面の指示に従ってPostmanデスクトップアプリを起動してください。

    2. Postmanで目的のワークスペースのページで、左側のナビゲーションメニューにあるImportをクリックします。

    3. TiDB CloudダイアログからデータアプリのURLをコピーし、そのURLをPostmanに貼り付けてインポートします。

  5. URLを貼り付けると、Postmanはデータアプリを新しいコレクションとして自動的にインポートします。コレクション名はTiDB Data Service - <Your App Name>形式です。

    コレクション内では、デプロイ済みのエンドポイントはDeployedフォルダーに、デプロイされていないエンドポイントはDraftフォルダーにグループ化されます。

ステップ2. PostmanでデータアプリAPIキーを設定します

Postmanでインポートしたデータアプリを実行する前に、PostmanでデータアプリのAPIキーを次のように設定する必要があります。

  1. Postman の左側のナビゲーション メニューでTiDB Data Service - <Your App Name>をクリックすると、右側にタブが開きます。
  2. TiDB Data Service - <Your App Name>タブの下にあるVariablesタブをクリックします。
  3. 変数テーブルのCurrent value列に、データアプリの公開鍵と秘密鍵を入力してください。
  4. TiDB Data Service - <Your App Name>タブの右上隅にあるSaveをクリックします。

ステップ3. Postmanでデータアプリを実行する

Postmanでデータアプリを実行するには、以下の手順に従ってください。

  1. Postmanの左側のナビゲーションペインで、 DeployedまたはDraftフォルダーを展開し、エンドポイント名をクリックして右側にタブを開きます。

  2. <Your Endpoint Name>タブでは、次のようにエンドポイントを呼び出すことができます。

    • パラメータのないエンドポイントの場合は、 Sendをクリックして直接呼び出すことができます。

    • パラメータ付きのエンドポイントの場合は、まずパラメータ値を入力してからSendをクリックする必要があります。

      • GETまたはDELETEリクエストの場合は、Query Paramsテーブルのパラメータ値を入力してください。
      • POSTまたはPUTリクエストの場合は、 Bodyタブをクリックし、パラメーター値を JSON オブジェクトとして入力します。TiDB Cloud Data Service のエンドポイントでBatch Operationが有効になっている場合は、パラメーター値を JSON オブジェクトの配列としてitemsフィールドに入力します。

  3. 下部のペインで応答を確認してください。

  4. 異なるパラメータ値でエンドポイントを再度呼び出したい場合は、パラメータ値を適切に編集してから、再度Sendをクリックしてください。

Postman の使用法の詳細については、 Postmanのドキュメントを参照してください。

データアプリの新しい変更点に対応する

データアプリがPostmanにインポートされた後、 TiDB Cloud Data Serviceはデータアプリの新しい変更をPostmanに自動的に同期しません。

Postmanに新しい変更を反映させるには、 再度インポートプロセスに従う必要があります。Postmanワークスペースではコレクション名が一意であるため、最新のデータアプリを使用して以前にインポートしたものを置き換えるか、最新のデータアプリを新しいコレクションとしてインポートすることができます。

また、データアプリを再インポートした後、Postman で新しくインポートしたデータアプリのAPIキーを設定します

このページは役に立ちましたか？