このガイドでは、アカウントの設定から最初の API リクエストの実行まで、すばやく開始するための手順を説明します。動画ガイド#
前提条件#
Pet Store プロジェクトは、主要な概念と機能を学ぶための Apidog 組み込みサンプルです。Apidog のようこそページで Create Sample Project をクリックして開始してください。 開発モデルの選択#
Apidog は、主に 2 つの API 開発アプローチをサポートしています。| モデル | 説明 | 最適な用途 | ワークフロー |
|---|
| Design-first | 実装前に API 仕様を定義します | 計画とドキュメントを重視するチーム | 仕様 → リクエスト → テスト → 共有 |
| Request-first | 実際のリクエストから API を構築してテストします | アジャイルチーム、プロトタイピング、ドキュメント化されていない API | リクエスト → 仕様 → テスト → 共有 |
Design-first モデル#
Design-first アプローチでは、API 仕様を事前に定義し、実装前に明確性と一貫性を確保します。この方法は、計画を重視し、最初から包括的なドキュメントを作成したいチームに最適です。1
新しいエンドポイントを指定するパス、メソッド、パラメータ、レスポンスを使用して API エンドポイントを定義します。これにより、API 仕様の基盤が作成されます。
4
アサーションを追加するAPI レスポンスが期待される条件を満たしていることを確認するための自動チェックを設定します。
7
高度な機能を確認する環境、スキーマ、コラボレーションツールなど、Apidog の機能をさらに詳しく確認します。
Design-first で開始
最初のエンドポイントを指定するRequest-first モデル#
Request-first アプローチは実際の API 呼び出しから開始し、API をすばやくプロトタイプ化して検証できるようにします。この方法は、既存のバックエンド、サードパーティ API、またはドキュメント化されていないエンドポイントをドキュメント化する必要がある場合に最適です。1
リクエストを送信する既存のエンドポイントをテストまたは調査するために API 呼び出しを実行します。
Request-first で開始
最初のリクエストを送信するモードの切り替え#
インターフェースの左下隅にあるトグルを使用して、Design-first モードと Request-first モードをいつでも切り替えられます。この柔軟性により、プロジェクトの進行に合わせてワークフローを調整できます。 Modified at 2026-06-11 07:06:02