APIエンドポイントのテスト
Workatoでは、APIエンドポイントがレシピベースであるかプロキシベースであるかに関係なく、テストできます。
レシピエンドポイントのテスト
レシピエンドポイントをテストする場合は、まず対応するAPIレシピを設定する必要があります。
エンドポイントに対応するAPIレシピが実行中であることを確認します。 これは、レシピを開始するか、レシピのテストモードを有効にすることで実行できます。
APIレシピコレクションページから、テストするエンドポイントを開きます。
レシピベースのエンドポイントは、テストする前にアクティブにする必要があります。 エンドポイントをまだアクティブにしていない場合は、ページ右上の非アクティブトグルを選択してアクティブに変更します。
APIレシピエンドポイントをアクティブ化
エンドポイントのアクティブ化の詳細については、エンドポイントのアクティブ化または非アクティブ化を参照してください。
パラメーターセクションの右側にある試すボタンを選択します。
APIレシピエンドポイントの試すボタン
必要なパス、クエリ、または本文のパラメーターをパラメーターセクションに入力します。
次のスクリーンショットは、必須のusernameパスパラメーターが入力されたレシピエンドポイントを示しています:
レシピエンドポイントのパスパラメーターの入力
実行を選択してテストリクエストを送信します。
次のレシピエンドポイントのスクリーンショットは、200成功コードを含むテストレスポンスを示しています:
成功したテストレスポンス
サンプルcurlコマンドの使用
レスポンスセクションには、コピーしてターミナルで実行し、レシピエンドポイントをテストできるサンプルcurlコマンドが含まれています。 ターミナルでコマンドを実行する前に、次の手順を完了する必要があることに注意してください:
- APIクライアントを作成します。
- アクセスプロファイルを作成して、テストするレシピエンドポイントを含むコレクションへのアクセス権をクライアントに付与します。
- アクセスプロファイルの作成時に生成された認証トークンをコピーします。
- サンプルcurlコマンドに
-H 'api-token: <your-api-token>'を自分で追加します。 例:
curl -X 'GET' \
'https://api.na.workato.com/exampleuser/subscription-api-v1/user/rsloan' \
-H 'accept: application/json' \
-H 'api-token: 1234567890abcdefgh'対応するレシピのジョブタブを表示して、実行したばかりのテストジョブを確認します。 詳細を確認するには、ジョブを選択します。
プロキシエンドポイントのテスト
OpenAPI仕様からコレクションを作成した直後に、プロキシエンドポイントをテストできます。これは、Workatoが指定されたターゲットURLにリクエストを転送するだけであるためです。
まだ作成していない場合は、APIクライアントを作成します。
新しいアクセスプロファイルを作成するか既存のアクセスプロファイルを編集して、テストするエンドポイントを含むAPIプロキシコレクションへのアクセス権をAPIクライアントに付与します。
APIプロキシコレクションページから、テストするエンドポイントを開き、テストタブに移動します。
パラメーターセクションの試すボタンを選択します:
APIプロキシエンドポイントの試すボタン
必要なパス、クエリ、または本文のパラメーターをパラメーターセクションに入力します。
次のスクリーンショットは、必須のorderIdパスパラメーターが値1に設定されたプロキシエンドポイントを示しています:
プロキシエンドポイントのパスパラメーターの入力
認証ボックスで、トークンを編集ボタンを選択します:
トークンを編集ボタンを選択
認証方法選択リストから認証方法を選択し、クライアントのアクセストークンまたは認証トークンをトークンフィールドに入力します。
トークンを設定を選択して認証トークンを確認します。
実行を選択してテストリクエストを送信します。
次のプロキシエンドポイントのスクリーンショットは、200成功コードとダウンロード可能なレスポンス本文を含むテストレスポンスを示しています:
成功したテストレスポンス
サンプルcurlコマンドの使用
レスポンスセクションには、コピーしてターミナルで実行できるサンプルcurlコマンドが含まれています。 コマンドに-H 'API-TOKEN: <your-API-TOKEN>'を自分で追加する必要があることに注意してください。 例:
curl -X 'GET' \
'https://api.na.workato.com/exampleuser/store/order/1' \
-H 'accept: application/json' \
-H 'api-token: 1234567890abcdefgh'エラー
レスポンス値が2XXでない場合、テストはエラーになります。 エラーには多数の原因が考えられます。
APIレシピを所有する同じアカウントからテストを実行する際に最も一般的なエラーは、"Invalid request" (400)です。 これは通常、入力パラメーターが正しくない、必要なパラメーターがすべて指定されていない、またはターゲットレシピに対して無効な値が含まれていることを示します。
エンドポイントを設定している場合は、次のセクションに進んでエンドポイントをアクティブ化します。
Last updated: