一般設定#
対象とインポート先#
| オプション | 説明 |
|---|
| Basic Auth | ユーザー名/パスワード認証が必要な URL インポートに使用します。 |
| Target Branch | データをインポートする特定のブランチを選択します（デフォルトは main です）。 |
| Import Into | 既存のフォルダー/モジュールにインポートするか、新規作成するかを選択します。 |
| Auto Generate Case | 有効にすると、仕様に例が含まれていない場合、Apidog が「Success」テストケースを自動的に作成します。 |
環境のインポート#
OpenAPI/Swagger ファイルで複数のサーバーが定義されている場合、Import Servers as Environments を有効にすると、Apidog 内に対応する環境が自動的に作成されます。セキュリティと命名#
セキュリティスキーム#
OpenAPI の securitySchemes の処理方法を制御します。Global Auth: 仕様のグローバルセキュリティを、Apidog のルートフォルダーの認証にマッピングします。
Undefined Auth: 特定のセキュ リティが設定されていないエンドポイントに対する動作を決定します（例: 「親から継承」または「認証なし」）。
エンドポイントの命名#
エンドポイントに説明的な Summary フィールドがない場合、名前のフォールバック元を選択できます。競合解決#
インポートされたデータが既存のデータと一致する場合（Method と Path に基づく）、以下のルールを使用して結果を決定します。エンドポイントの競合#
| 戦略 | 動作 |
|---|
| Overwrite | 古いエンドポイントを新しいデータで完全に置き換えます。 |
| Keep Both | 重複を作成し、古いものと新しいものの両方を並べて保持します。 |
| Ignore | 新しいエンドポイントをスキップし、古いものを変更せずに保持します。 |
| Merge | スマート更新: 定義を更新しながら、名前、モックルール、説明などの手動変更を保持します。 |
| Overwrite Selected | 選択した特定のフィールドのみを更新し、その他は保持します。 |
その他のリソース（スキーマ / ドキュメント）#
Markdown ドキュメント、スキーマ、コンポーネントについても、同様に Overwrite と Merge のオプションが適用されます。高度な同期ロジック#
フォルダーの同期#
インポートされたエンドポイントがプロジェクト内の既存のエンドポイントと一致するものの、フォルダーの場所が異なる場合:Keep existing folder: インポートファイル内のフォルダーパスを無視します。エンドポイントは Apidog 内の現在のフォルダーに残ります。
Update endpoint folder: エンドポイントを、 インポートファイルで定義されたフォルダー構造に移動します。
リソースのクリーンアップ#
プロジェクト内に存在していたものの、新しいインポートファイルには含まれていないリソースをどう扱うかを決定します。Do not delete（安全）: 孤立したリソースをプロジェクト内に保持します。
Delete（同期）: 新しいファイルに存在しないリソースをすべて削除します。仕様の正確なミラーを維持するために使用する場合は、注意して使用してください。
Modified at 2026-06-11 07:06:02
