サービス接続レスポンスのテスト
POST/PATCH/PUT REST APIをapplication/octet-streamまたはmultipart/form-data形式で構成し、続行する前にサービス接続エンドポイントのテスト・タブからテストできます。 RESTエンドポイントをコールするときに、フォーム・データ・スキーマを使用することもできます。
この機能は、ラジオ・ボタンを使用してテストするペイロード・タイプを選択できる2つの場所からアクセスできます:
- エンドポイント・エディタのリクエストタブの下の本文タブから:
- テストタブの下の本文パネルから:
両方のスクリーンショットでは、テキスト・ペイロード・オプションが選択されています。 ラジオ・ボタンの下の本文入力領域は、以前のすべてのリリースで同じように表示され、動作します。
フォーム・データ・オプションを使用したレスポンスのテスト
Form-Dataペイロード・オプションを選択すると、メディア・タイプは自動的にmultipart/form-dataに変更され、マルチパート・リクエスト本文でデータ値を提供する入力要素を定義するフォームが表示されます:
次の2つのタイプの入力要素を作成できます:
- 文字列。ユーザーが入力したテキスト値を指定します。
- ファイル。バイナリ・データ値を指定するファイルを選択します。
要素がフォームに追加されると、対応するプロパティがOpenAPIメタデータのメディア・タイプ・スキーマに追加されます:
リクエストが「テスト」タブから送信されると、入力の名前と値を使用して、マルチパート・ペイロードを定義するFormDataオブジェクトが生成されます。
フォーム要素を作成してリクエストタブに表示すると、フォーム・データのテストと送信は実行できないため、入力要素自体(テキスト・フィールドまたはファイル・ピッカー)はレンダリングされません:
バイナリ・オプションを使用したレスポンスのテスト
バイナリ・ペイロード・オプションを選択すると、メディア・タイプはデフォルトでapplication/octet-streamになりますが、任意のバイナリ・コンテンツ・タイプを手動で入力できます:
「バイナリ互換スキーマの作成」ボタンをクリックすると、対応するスキーマが生成されます。
スキーマの作成後、ファイル・ピッカーを使用して、リクエストの送信時にバイナリ・ペイロードとして使用されるファイルを選択できます:
バイナリ・ペイロード・タイプのファイル・ピッカーは、リクエスト・タブに表示されません:
かわりに、スキーマが作成されたことを示すメッセージが表示されます。
サービス・エンドポイントでは、エンドポイントのテスト・タブでのバイナリまたはテキスト・レスポンスのダウンロードがサポートされます。 「ダウンロード」ボタンを使用して、レスポンス本文を保存できます。 レスポンスが非テキストの場合、レスポンス本文にバイナリ・データが含まれていることを示すメッセージが表示されます:
ダウンロードボタンを使用して、テキスト・レスポンスをダウンロードまたは保存することもできます: