エンドポイントの Run タブで Send をクリックして、リクエストを送信します。エンドポイントの Run インターフェースと Request インターフェースは非常によく似ています。主な違いは、Run はエンドポイントに基づいており、エンドポイント仕様に基づいてリクエストを生成し、レスポンスを検証できる点です。エンドポイント仕様が変更されると、Run インターフェースもそれに応じて更新されます。 一方、Requests は独立しており、API 仕様とは関連していません。リクエストの送信#
リクエストを送信すると、Apidog は API サーバーから受信したレスポンスを、確認、可視化、トラブルシューティングしやすい形式で表示します。このインターフェースは 2 つのセクションに分かれています。上半分は送信したいリクエストを入力する場所で、下半分には実際に送信したリクエスト、受信したレスポンス、およびレスポンスの検証結果とアサーション結果が表示されます。右下隅の partition ボタンにカーソルを合わせると、Run インターフェースのレイアウトを調整できます。インターフェースを水平分割、垂直分割、または分割なしから選択できます。 実際のリクエスト#
上半分のセクションでは、変数、動的値、スクリプトなどを利用して、送信するリクエストを調整できます。実際に送信されるリクエストを確認するにはどうすればよいでしょうか。下半分の Actual Request タブで 、完全な実際のリクエストを確認できます。レスポンスの検証#
Apidog は、エンドポイントの仕様に基づいて、レスポンスがスキーマに準拠しているかどうかを自動的に検証します。検証の有効化または無効化を選択できるほか、どのレスポンスに対して検証するかも選択できます。レスポンスの抽出#
Apidog は、レスポンスをエンドポイント仕様に抽出することをサポートしています。これは response schema または response examples として抽出できます。リクエストの変更#
Run タブでリクエストを変更できます。パラメータ値を変更したり、パラメータの前にあるチェックボックスを切り替えたりして、リクエストを変更できます。これらの操作はエンドポイント仕様と競合し ません。場合によっては、パラメータの型を変更したり、パラメータを追加または削除したりする必要があります。この場合、リクエストはエンドポイント仕様から逸脱します。Apidog では、これらの不整合はオレンジ色で強調表示されます。これらのオレンジ色のマーカーにカーソルを合わせると、仕様と現在のリクエストの差分が表示されます。Revert をクリックすると仕様に一致する状態に戻すことができ、Save to endpoint spec をクリックすると仕様を更新できます。また、右上隅の Inconsistent ボタンをクリックして、すべての差分を一括で元に戻す、またはエンドポイント仕様に保存することもできます。